WebAssembly.instantiateStreaming()

source

一个Response 对象或一个将以一个对象为结果的承诺，表示要流式传输、编译和实例化的 Wasm 模块的底层源代码。

importObject 可选

一个包含要导入到新创建的 Instance 中的值的对象，例如函数或WebAssembly.Memory 对象。每个声明的导入的已编译模块都必须有一个匹配的属性，否则将抛出WebAssembly.LinkError。

一个Promise，它解析为一个ResultObject，其中包含两个字段

• module: 一个WebAssembly.Module 对象，表示已编译的 WebAssembly 模块。此 Module 可以再次实例化，也可以通过postMessage() 共享。
• instance: 一个WebAssembly.Instance 对象，其中包含所有导出的 WebAssembly 函数。

• 如果任一参数的类型或结构不正确，则会抛出TypeError。
• 如果操作失败，承诺将拒绝并抛出一个WebAssembly.CompileError、WebAssembly.LinkError 或WebAssembly.RuntimeError，具体取决于失败的原因。

以下示例（请参阅我们在 GitHub 上的instantiate-streaming.html 演示，以及实时查看它）直接从底层源代码流式传输 Wasm 模块，然后对其进行编译和实例化，承诺将以一个 ResultObject 为结果。因为 instantiateStreaming() 函数接受一个针对Response 对象的承诺，所以您可以直接将其传递给fetch() 调用，它将在承诺完成时将响应传递到函数中。

const importObject = {
  my_namespace: { imported_func: (arg) => console.log(arg) },
};

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

然后访问 ResultObject 的实例成员，并调用其中包含的导出的函数。

• WebAssembly 概述页面
• WebAssembly 概念
• 使用 WebAssembly JavaScript API