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

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

描述

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包含编译了的ModuleInstance对象。接下来我们调用一个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 初始草案定义

浏览器兼容性

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support5716522 No4411
CompileError5716522 No4411
Instance5716522 No4411
LinkError5716522 No4411
Memory5716522 No4411
Module5716522 No4411
RuntimeError5716522 No4411
Table5716522 No4411
compile5716522 No4411
compileStreaming61 No58 No47 No
instantiate5716522 No4411
instantiateStreaming61 No58 No47 No
validate5716522 No4411
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support5757 Yes1522 ?117.0
CompileError5757 Yes1522 ?117.0
Instance5757 Yes1522 ?117.0
LinkError5757 Yes1522 ?117.0
Memory5757 Yes1522 ?117.0
Module5757 Yes1522 ?117.0
RuntimeError5757 Yes1522 ?117.0
Table5757 Yes1522 ?117.0
compile5757 Yes1522 ?117.0
compileStreaming6161 No58 ? No No
instantiate5757 Yes1522 ?117.0
instantiateStreaming6161 No58 ? No No
validate5757 Yes1522 ?117.0

1. This feature is behind the Experimental JavaScript Features preference.

2. Disabled in the Firefox 52 Extended Support Release (ESR).

参见

文档标签和贡献者

标签: 
 此页面的贡献者: Gaohaoyang, zhangchen, chyingp, JianrongYu
 最后编辑者: Gaohaoyang,