JS WebAssembly

本文目录结构

WebAssemblyJavaScript 对象是所有 WebAssembly 相关功能的命名空间。

和大多数全局对象不一样，WebAssembly 不是一个构造函数（它不是一个函数对象）。它类似于 Math 对象或者 Intl 对象，Math 对象也是一个命名空间对象，用于保存数学常量和函数；Intl 则是用于国际化和其他语言相关函数的命名空间对象。

描述

WebAssembly 对象主要用于：

• 使用 WebAssembly.instantiate() 函数加载 WebAssembly 代码。
• 通过 WebAssembly.Memory()/WebAssembly.Table() 构造函数创建新的内存和表实例。
• 由 WebAssembly.CompileError()/WebAssembly.LinkError()/WebAssembly.RuntimeError() 构造函数来提供 WebAssembly 中的错误信息。

方法

WebAssembly.instantiate()

用于编译和实例化 WebAssembly 代码的主 API，返回一个 Module 和它的第一个实例。

WebAssembly.instantiateStreaming()

直接从流式底层源编译和实例化 WebAssembly 模块，同时返回 Module 及其第一个实例。

WebAssembly.compile()

把 WebAssembly 二进制代码编译为一个 WebAssembly.Module ，不进行实例化。

WebAssembly.compileStreaming()

直接从流式底层源代码编译 WebAssembly.Module ，将实例化作为一个单独的步骤。

WebAssembly.validate()

校验 WebAssembly 二进制代码的类型数组是否合法，合法则返回 true ，否则返回 false 。

构造器

WebAssembly.Module()

创建一个新的 WebAssembly 模块对象。

WebAssembly.Instance()

创建一个新的 WebAssembly 实例对象。

WebAssembly.Memory()

创建一个新的 WebAssembly 内存对象。

WebAssembly.Table()

创建一个新的 WebAssembly 表格对象。

WebAssembly.CompileError()

创建一个新的 WebAssembly 编译错误对象。

WebAssembly.LinkError()

创建一个新的 WebAssembly 链接错误对象。

WebAssembly.RuntimeError()

创建一个新的 WebAssembly 运行时错误对象。

示例

通过 fetch 方法获取了 WebAssembly 字节码后，我们通过 WebAssembly.instantiate() 方法对模块进行编译和实例化，在这过程中将一个 JavaScript 函数导入 WebAssembly 模块。这个 promise 实例解析成一个对象 (result)，result 包含编译了的 Module 和 Instance 对象。接下来我们调用一个 Instance 导出的 WebAssembly 方法。

var importObject = {
  imports: {
    imported_func: function(arg) {
      console.log(arg);
    }
  }
};
fetch('simple.wasm').then(response =>
  response.arrayBuffer()
).then(bytes =>
  WebAssembly.instantiate(bytes, importObject)
).then(result =>
  result.instance.exports.exported_func()
);

注意：有关使用了我们 fetchAndInstantiate() 库函数的示例，请查看 Github 上的 index.html （或者查看在线示例） 。

规范

Specification	Status	Comment
WebAssembly JavaScript Interface WebAssembly	Working Draft	初始草案定义