WebAssembly.compile
WebAssembly.compile
这是一个实验中的功能
在使用此产品之前,请仔细检查浏览器兼容性表。
WebAssembly.compile()
方法编译WebAssembly二进制代码到一个WebAssembly.Module
对象。如果在实例化之前有必要去编译一个模块,那么这个方法是有用的(否则,将会使用WebAssembly.instantiate()
方法)
语法
Promise<WebAssembly.Module> WebAssembly.compile(bufferSource
参数
bufferSource
一个包含你想编译的wasm模块二进制代码的typed array(类型数组) orArrayBuffer(数组缓冲区)
返回值
一个解析为WebAssembly.Module
的Promise
对象。
异常
- 如果
bufferSource
不是一个 typed array, 将抛出一个TypeError
。
- 如果编译失败 promise 将会 reject 一个
WebAssembly.CompileError
。
示例
下面的例子 (查看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()
方法创建了一个实例,调用从它里面导出的一个方法,接下来展示了我们可以用WebAssembly.Module.exports
属性来调用模块上返回的可用信息。
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(
}
var exports = WebAssembly.Module.exports(mod
console.log(exports[0]
};
规范
Specification | Status | Comment |
---|---|---|
Web Assembly JavaScript APIThe definition of 'compile()' in that specification. | Draft | Initial draft definition. |
浏览器兼容性
Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | 57 | 16 | 522 | No | 44 | 11 |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | 57 | 57 | (Yes)1 | 522 | No | ? | 11 |