WebAssembly.Module.exports()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.
The WebAssembly.Module.exports()
static method returns an
array containing descriptions of all the declared exports of the given
Module
.
Syntax
WebAssembly.Module.exports(module)
Parameters
module
-
A
WebAssembly.Module
object.
Return value
An array containing objects representing the exported functions of the given module.
Exceptions
If module is not a WebAssembly.Module
object instance, a
TypeError
is thrown.
Examples
Using exports
The following example (see our index-compile.html
demo on GitHub, and view it live also)
compiles the loaded simple.wasm byte code using the
WebAssembly.compileStreaming()
method and then sends it to a worker using postMessage().
const worker = new Worker("wasm_worker.js");
WebAssembly.compileStreaming(fetch("simple.wasm")).then((mod) =>
worker.postMessage(mod),
);
In the worker (see
wasm_worker.js
)
we define an import object for the module to use, then set up an event handler to
receive the module from the main thread. When the module is received, we create an
instance from it using the WebAssembly.Instantiate()
method, invoke an
exported function from inside it, then show how we can return information on the
available exports on a module using WebAssembly.Module.exports
.
const importObject = {
my_namespace: {
imported_func(arg) {
console.log(arg);
},
},
};
onmessage = (e) => {
console.log("module received from main thread");
const mod = e.data;
WebAssembly.instantiate(mod, importObject).then((instance) => {
instance.exports.exported_func();
});
const exports = WebAssembly.Module.exports(mod);
console.log(exports[0]);
};
The exports[0]
output looks like this:
{ name: "exported_func", kind: "function" }
Specifications
Specification |
---|
WebAssembly JavaScript Interface # dom-module-exports |
Browser compatibility
BCD tables only load in the browser