WebAssembly.instantiate()

Promise<ResultObject> WebAssembly.instantiate(bufferSource, importObject);

参数

bufferSource

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

importObject 可选

一个将被导入到新创建实例中的对象，它包含的值有函数、WebAssembly.Memory 对象等等。编译的模块中，对于每一个导入的值都要有一个与其匹配的属性与之相对应，否则将会抛出 WebAssembly.LinkError。

返回值

解析为包含两个字段的 ResultObject 的一个 Promise:

• module: 一个被编译好的 WebAssembly.Module 对象。这个模块可以被再次实例化，通过 postMessage() 被分享，或者缓存到 IndexedDB。
• instance: 一个包含所有 Exported WebAssembly functions的WebAssembly.Instance对象。

异常

• 如果参数的类型或结构不正确，将会抛出异常 TypeError .
• 如果操作失败，promise 将会被 reject 掉，根据失败的原因不同，会抛出 3 种异常，WebAssembly.CompileError，WebAssembly.LinkError, 或WebAssembly.RuntimeError。

Promise<WebAssembly.Instance> WebAssembly.instantiate(module, importObject);

参数

module

将被实例化的 WebAssembly.Module 对象。

importObject 可选

一个将被导入到新创建实例中的对象，它包含的值有函数、WebAssembly.Memory 对象等等。编译的模块中，对于每一个导入的值都要有一个与其匹配的属性与之相对应，否则将会抛出WebAssembly.LinkError 。

返回值

一个解析为 WebAssembly.Instance 的Promise 对象。

异常

• 如果参数的类型或结构不正确，将抛出异常 TypeError 。
• 如果操作失败，promise 将会被 reject 掉，根据失败的原因不同，会抛出 3 种异常，WebAssembly.CompileError，WebAssembly.LinkError, 或WebAssembly.RuntimeError。

使用 fetch 获取一些 WebAssembly 二进制代码后，我们使用 WebAssembly.instantiate() 方法编译并实例化模块，在此过程中，导入了一个 Javascript 方法在 WebAssembly 模块中，接下来我们使用Instance 导出的 Exported WebAssembly 方法。

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

/* 2019-08-03：importObject 必须存在 env 对象以及 env 对象的 abort 方法 */

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => WebAssembly.instantiate(bytes, importObject))
  .then((result) => result.instance.exports);

下面的例子（查看我们 GitHub 的 index-compile.html 例子，可在线演示）使用 compile() 方法编译了 simple.wasm 字节码，然后通过 postMessage() 发送给一个线程 worker。

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() 方法创建一个实例并且调用它从内部导出的函数。

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();
  });
};

• WebAssembly overview page
• WebAssembly concepts
• Using the WebAssembly JavaScript API