WebAssembly.instantiateStreaming()

source

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

importObject 可选

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

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

• module: WebAssembly.Module 对象表示编译完成的 WebAssembly 模块。这个Module能够再次被实例化 或 通过postMessage()共享。
• instance: WebAssembly.Instance 对象包含 WebAssembly 所有公开方法 Exported WebAssembly functions.

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

下面的示例 (在 GitHub 上查看 instantiate-streaming.html 示例，并且也可 view it live ) 直接从基础源传输一个 .wasm 模块，然后进行编译和实例化，Promise 履行后返回一个 ResultObject. 因为 instantiateStreaming() 方法允许履行后返回Response对象的 Promise，你可以直接传递一个 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的实例成员，并调用包含的公开函数。

• WebAssembly overview page
• WebAssembly concepts
• Using the WebAssembly JavaScript API
• Promise
• 使用 Fetch