WebAssembly.LinkError

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.LinkError object indicates an error during module instantiation (besides traps from the start function).

Constructor

WebAssembly.LinkError(): Creates a new WebAssembly.LinkError object.

Instance properties

WebAssembly.LinkError.prototype.message: Error message. Inherited from Error.
WebAssembly.LinkError.prototype.name: Error name. Inherited from Error.
WebAssembly.LinkError.prototype.cause: Error cause. Inherited from Error.
WebAssembly.LinkError.prototype.fileName Non-standard: Path to file that raised this error. Inherited from Error.
WebAssembly.LinkError.prototype.lineNumber Non-standard: Line number in file that raised this error. Inherited from Error.
WebAssembly.LinkError.prototype.columnNumber Non-standard: Column number in line that raised this error. Inherited from Error.
WebAssembly.LinkError.prototype.stack Non-standard: Stack trace. Inherited from Error.

Instance methods

WebAssembly.LinkError.prototype.toString(): Returns a string representing the specified Error object. Inherited from Error.

Examples

Creating a new LinkError instance

The following snippet creates a new LinkError instance, and logs its details to the console:

try {
  throw new WebAssembly.LinkError("Hello", "someFile", 10);
} catch (e) {
  console.log(e instanceof LinkError); // true
  console.log(e.message); // "Hello"
  console.log(e.name); // "LinkError"
  console.log(e.fileName); // "someFile"
  console.log(e.lineNumber); // 10
  console.log(e.columnNumber); // 0
  console.log(e.stack); // returns the location where the code was run
}

Specifications

Specification
WebAssembly JavaScript Interface # exceptiondef-linkerror
ECMAScript Language Specification # sec-native-error-types-used-in-this-standard

Browser compatibility

BCD tables only load in the browser