W3cubDocs

WebAssembly.Module() constructor

A WebAssembly.Module() constructor creates a new Module object containing stateless WebAssembly code that has already been compiled by the browser and can be efficiently shared with Workers, and instantiated multiple times.

The WebAssembly.Module() constructor function can be called to synchronously compile given WebAssembly binary code. However, the primary way to get a Module is through an asynchronous compilation function like WebAssembly.compile().

Syntax

Warning: Since compilation for large modules can be expensive, developers should only use the Module() constructor when synchronous compilation is absolutely required; the asynchronous WebAssembly.compileStreaming() method should be used at all other times.

new WebAssembly.Module(bufferSource)

Parameters

bufferSource: A typed array or ArrayBuffer containing the binary code of the .wasm module you want to compile.

Exceptions

If the parameter is not of the correct type or structure, a TypeError is thrown.
If compilation fails, the constructor rejects with a WebAssembly.CompileError.
Some browsers may throw a RangeError, as they prohibit compilation and instantiation of Wasm with large buffers on the UI thread.

Examples

Synchronously compiling a WebAssembly module

const importObject = {
  imports: {
    imported_func(arg) {
      console.log(arg);
    }
  }
};

function createWasmModule(bytes) {
  return new WebAssembly.Module(bytes);
}

fetch('simple.wasm').then((response) =>
  response.arrayBuffer()
).then((bytes) => {
  const mod = createWasmModule(bytes);
  WebAssembly.instantiate(mod, importObject)
  .then((result) =>
    result.exports.exported_func()
  );
})

Specifications

Specification
WebAssembly JavaScript Interface: Exception Handling # dom-module-module

Browser compatibility

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	Deno	Node.js
`Module`	57	16	52	No	44	11	57	57	52	43	11	7.0	1.0	8.0.0