WebAssembly.Instance

一个 WebAssembly.Instance 对象是 WebAssembly.Module 的可执行状态实例。Instance 对象包含所有 导出的 WebAssembly 函数,允许从 JavaScript 调用 WebAssembly 代码。

构造函数

WebAssembly.Instance()

创建一个新的 Instance 对象。

实例属性

exports

返回一个对象,该对象包含作为其成员从 WebAssembly 模块实例导出的所有函数,以便允许 JavaScript 访问和使用它们。只读。

示例

同步实例化 WebAssembly 模块

WebAssembly.Instance() 构造函数可以被调用来同步实例化给定的 WebAssembly.Module 对象,例如

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

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => {
    const mod = new WebAssembly.Module(bytes);
    const instance = new WebAssembly.Instance(mod, importObject);
    instance.exports.exported_func();
  });

获取 Instance 的首选方法是异步的,例如使用 WebAssembly.instantiateStreaming() 函数,如下所示

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

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

这还演示了如何使用 exports 属性访问导出的函数。

规范

规范
WebAssembly JavaScript 接口
# instances

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅