WebAssembly.RuntimeError() constructor
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.RuntimeError() constructor creates a new
WebAssembly RuntimeError object — the type that is thrown whenever
WebAssembly specifies a trap.
Syntax
new WebAssembly.RuntimeError()
new WebAssembly.RuntimeError(message)
new WebAssembly.RuntimeError(message, options)
new WebAssembly.RuntimeError(message, fileName)
new WebAssembly.RuntimeError(message, fileName, lineNumber)
Parameters
messageOptional-
Human-readable description of the error.
optionsOptional-
An object that has the following properties:
causeOptional-
A property indicating the specific cause of the error. When catching and re-throwing an error with a more-specific or useful error message, this property can be used to pass the original error.
fileNameOptional-
The name of the file containing the code that caused the exception.
lineNumberOptional-
The line number of the code that caused the exception.
Examples
Creating a new RuntimeError instance
The following snippet creates a new RuntimeError instance, and logs its
details to the console:
try {
throw new WebAssembly.RuntimeError("Hello", "someFile", 10);
} catch (e) {
console.log(e instanceof WebAssembly.RuntimeError); // true
console.log(e.message); // "Hello"
console.log(e.name); // "RuntimeError"
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-runtimeerror |
| ECMAScript® 2027 Language Specification # sec-nativeerror-constructors |
Browser compatibility
| desktop | mobile | server | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
RuntimeError() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support