WebAssembly.LinkError() Konstruktor

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.

Der WebAssembly.LinkError() Konstruktor erzeugt ein neues WebAssembly LinkError Objekt, das einen Fehler während der Modulintegration anzeigt (neben traps von der Startfunktion).

Syntax

js
new WebAssembly.LinkError()
new WebAssembly.LinkError(message)
new WebAssembly.LinkError(message, options)
new WebAssembly.LinkError(message, fileName)
new WebAssembly.LinkError(message, fileName, lineNumber)

Parameter

message Optional

Menschlich lesbare Beschreibung des Fehlers.

options Optional

Ein Objekt, das die folgenden Eigenschaften hat:

cause Optional

Eine Eigenschaft, die die spezifische Ursache des Fehlers angibt. Diese Eigenschaft kann verwendet werden, um den ursprünglichen Fehler weiterzugeben, wenn ein Fehler mit einer spezifischeren oder nützlicheren Fehlermeldung abgefangen und erneut geworfen wird.

fileName Optional Nicht standardisiert

Der Name der Datei, die den Code enthält, der die Ausnahme verursacht hat.

lineNumber Optional Nicht standardisiert

Die Zeilennummer des Codes, der die Ausnahme verursacht hat.

Beispiele

Erstellen einer neuen LinkError-Instanz

Das folgende Codebeispiel erstellt eine neue LinkError Instanz und protokolliert deren Details in der Konsole:

js
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
}

Spezifikationen

Specification
WebAssembly JavaScript Interface
# exceptiondef-linkerror
ECMAScript® 2025 Language Specification
# sec-nativeerror-constructors

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch