WebAssembly.instantiateStreaming()

WebAssembly.instantiateStreaming() 方法直接从流式底层源编译和实例化 WebAssembly 模块。这是加载 wasm 代码一种非常有效的优化方式。

Syntax

Promise<ResultObject> WebAssembly.instantiateStreaming(source, importObject);

Parameters

source

一个Response对象 或 一个可以履行(fulfill)一个(Response)的 Promise,表示你想要传输、编译和实例化的 .wasm 模块基础源。

importObject 可选

包含一些想要导入到新创建Instance中值的对象,例如方法 或 WebAssembly.Memory 对象。每个已编译模块的声明导入必须有一个匹配属性,否则抛出 WebAssembly.LinkError (en-US) 异常。

Return value

一个 Promise,通过 resolve 返回一个包含两个属性的 ResultObject

Exceptions

Examples

下面的示例 (在 GitHub 上查看 instantiate-streaming.html 示例,并且也可 view it live ) 直接从基础源传输一个 .wasm 模块,然后进行编译和实例化,Promise 履行后返回一个 ResultObject. 因为 instantiateStreaming() 方法允许履行后返回Response对象的 Promise,你可以直接传递一个 fetch() 请求,它会在履行后将 response 传递给方法。

js

var importObject = { imports: { imported_func: (arg) => console.log(arg) } };

WebAssembly.instantiateStreaming(fetch("simple.wasm"), importObject).then(
  (obj) => obj.instance.exports.exported_func(),
);

然后访问ResultObject的实例成员,并调用包含的公开函数。

Specifications

Specification
WebAssembly Web API
# dom-webassembly-instantiatestreaming

浏览器兼容性

BCD tables only load in the browser

See also