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 异常。

Return value

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

• module: postMessage()共享。
• instance:WebAssembly.Instance对象包含WebAssembly所有公开方法 Exported WebAssembly functions.

Exceptions

• 如果任意参数的类型或结构错误,TypeError抛出.
• 如果操作失败, Promise通过reject根据失败原因返回WebAssembly.RuntimeError。

Examples

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

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

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

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