WebAssembly.Module

WebAssembly.Module 对象包含已经由浏览器编译的无状态 WebAssembly 代码,可以高效地与 Worker 共享和多次实例化。

构造函数

WebAssembly.Module() (en-US)

创建一个新的 Module 对象。

静态属性

WebAssembly.Module.customSections() (en-US)

给定一个 Module 和字符串,返回模块中具有给定字符串名称的所有自定义的部分的内容副本。

WebAssembly.Module.exports() (en-US)

给定一个 Module,返回一个数组,其中包含所有声明的导出的描述。

WebAssembly.Module.imports() (en-US)

给定一个 Module,返回一个数组,其中包含所有声明的导入的描述。

示例

将编译后的模块发送到 worker

以下示例将使用 WebAssembly.compileStreaming() 方法编译 simple.wasm 加载后的字节码,并将返回的 Module 实例通过 postMessage() 发送到一个 worker

参见 index-compile.html源代码,或查看在线演示

js
const worker = new Worker("wasm_worker.js");

WebAssembly.compileStreaming(fetch("simple.wasm")).then((mod) =>
  worker.postMessage(mod),
);

Worker 函数 wasm_worker.js 定义了模块需要使用的导入对象。然后,该函数会创建一个事件处理器,以接受主线程发送的模块。在接收到模块后,我们使用 WebAssembly.instantiate() 方法创建一个它的实例,然后调用其导出的函数。

js
const importObject = {
  imports: {
    imported_func(arg) {
      console.log(arg);
    },
  },
};

onmessage = (e) => {
  console.log("module received from main thread");
  const mod = e.data;

  WebAssembly.instantiate(mod, importObject).then((instance) => {
    instance.exports.exported_func();
  });
};

规范

Specification
WebAssembly JavaScript Interface
# modules

浏览器兼容性

BCD tables only load in the browser

参见