WebAssembly.compile()

实验性: 这是一项实验性技术
在将其用于生产之前,请仔细检查浏览器兼容性表格

WebAssembly.compile() 方法编译 WebAssembly 二进制代码到一个WebAssembly.Module 对象。如果在实例化之前有必要去编译一个模块,那么这个方法是有用的(否则,将会使用WebAssembly.instantiate() 方法)

语法

Promise<WebAssembly.Module> WebAssembly.compile(bufferSource);

参数

bufferSource

一个包含你想编译的 wasm 模块二进制代码的 typed array(类型数组) or ArrayBuffer(数组缓冲区)

返回值

一个解析为 WebAssembly.ModulePromise 对象。

异常

示例

下面的例子 (查看 GitHub 上的 index-compile.html 例子,并且也能 查看运行效果) 使用 compile() 方法编译加载进来的 simple.wasm 二进制代码并且使用 postMessage() 发送给一个 worker

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

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => WebAssembly.compile(bytes))
  .then((mod) => worker.postMessage(mod));

在线程中 (查看 wasm_worker.js) 我们定义了一个导入对象共模块使用,然后设置了一个事件处理函数来接收主线程发送过来的模块。当模块被接收之后,我们使用WebAssembly.Instantiate() 方法创建了一个实例,调用从它里面导出的一个方法,接下来展示了我们可以用 WebAssembly.Module.exports 属性来调用模块上返回的可用信息。

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

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

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

  var exports = WebAssembly.Module.exports(mod);
  console.log(exports[0]);
};

Specifications

Specification
WebAssembly JavaScript Interface
# dom-webassembly-compile

Browser compatibility

BCD tables only load in the browser

See also