02 JS WASM

JavaScript 对象是所有 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 和它的第一个Instance实例
WebAssembly.instantiateStreaming()直接从流式底层源编译和实例化WebAssembly模块,同时返回Module及其第一个Instance实例
WebAssembly.compile()把 WebAssembly 二进制代码编译为一个 WebAssembly.Module ,不进行实例化
WebAssembly.compileStreaming()直接从流式底层源代码编译 WebAssembly.Module ,将实例化作为一个单独的步骤
WebAssembly.validate()校验 WebAssembly 二进制代码的类型数组是否合法,合法则返回 true ,否则返回 false

构造器

构造器描述
WebAssembly.Global()创建一个新的 WebAssembly Global 全局对象
WebAssembly.Module()创建一个新的 WebAssembly Module 模块对象
WebAssembly.Instance()创建一个新的 WebAssembly Instance 实例对象
WebAssembly.Memory()创建一个新的 WebAssembly Memory 内存对象
WebAssembly.Table()创建一个新的 WebAssembly Table 表格对象
WebAssembly.CompileError()创建一个新的 WebAssembly CompileError 编译错误对象
WebAssembly.LinkError()创建一个新的 WebAssembly LinkError 链接错误对象
WebAssembly.RuntimeError()创建一个新的 WebAssembly RuntimeError 运行时错误对象

示例

var importObject = { imports: { imported_func: arg => console.log(arg) } };
WebAssembly.instantiateStreaming(fetch('simple.wasm'), importObject).then(obj => obj.instance.exports.exported_func())

上面例子,直接从流式底层源传输.wasm模块,然后对其进行编译和实例化,并通过ResultObject实现promise

由于instantiateStreaming()函数接受对 Response 对象的 promise,因此可以直接向其传递WindowOrWorkerGlobalScope.fetch()调用,然后它将把返回的response传递给随后的函数。

返回的ResultObject实例的成员可以被随后访问到,可以调用实例中被导出的方法。

上次修改: 25 July 2020