WebAssembly.Exception-Konstruktor
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Mai 2022 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Der Konstruktor WebAssembly.Exception() wird verwendet, um eine neue Instanz eines WebAssembly.Exception-Objekts zu erstellen.
Syntax
new Exception(tag, payload)
new Exception(tag, payload, options)
Parameter
tag-
Eine
WebAssembly.Tag-Instanz, die die erwarteten Datentypen für jeden Wert inpayloaddefiniert. payload-
Ein Array mit einem oder mehreren Datenfeldern, die die Nutzdaten der Ausnahme bilden. Die Elemente müssen den Datentypen der entsprechenden Elemente in
tagentsprechen. Wenn die Anzahl oder die Typen der Datenfelder nicht übereinstimmen, wird eineTypeError-Ausnahme ausgelöst. optionsOptional-
Ein Objekt mit den folgenden optionalen Feldern:
traceStackOptional-
true, wenn derException-Instanz ein Stacktrace in ihrerstack-Eigenschaft zugeordnet werden darf, andernfallsfalse. Der Standardwert istfalse.
Ausnahmen
TypeError-
Die Sequenzen
payloadundtagenthalten nicht gleich viele Elemente und/oder die Typen der Elemente stimmen nicht überein.
Beschreibung
Der Konstruktor Exception() nimmt ein WebAssembly.Tag, ein Array von Werten und ein options-Objekt als Argumente entgegen.
Das Tag definiert den Typ einer Ausnahme eindeutig, einschließlich der Reihenfolge ihrer Argumente und deren Datentypen.
Um auf die Argumente einer ausgelösten Ausnahme zuzugreifen, wird dasselbe Tag benötigt, mit dem die Exception erstellt wurde (mithilfe von Exception.prototype.getArg()).
Beispiele
>Grundlegende Verwendung
Normalerweise verwenden Sie diesen Konstruktor nicht, um eine Wasm-Ausnahme manuell zu erstellen. Stattdessen entsteht ein WebAssembly.Exception-Objekt üblicherweise bei der Behandlung von Wasm-Ausnahmen, beispielsweise:
WebAssembly.instantiateStreaming(fetch("module.wasm"), { env }).then(
(result) => {
try {
// Cause function to throw
result.instance.exports.throw(-1);
} catch (e) {
if (e instanceof WebAssembly.Exception && e.is(myErrorTag)) {
const errorCode = e.getArg(myErrorTag, 0); // 0 = first payload value
console.log("Error code:", errorCode); // 42
} else {
throw e; // throw other errors
}
}
},
);
Ein funktionsfähiges Beispiel finden Sie auf der Referenzseite zur Anweisung throw.
Manuelle Verwendung
Dieses Beispiel zeigt, wie Sie eine WebAssembly.Exception-Instanz manuell erstellen.
// Create tag and use it to create an exception
const tag = new WebAssembly.Tag({ parameters: ["i32", "f32"] });
const exception = new WebAssembly.Exception(tag, [42, 42.3]);
Hinweis:
Das Beispiel zu stack zeigt die Erstellung einer Ausnahme, die den Parameter options verwendet.
Spezifikationen
| Spezifikation |
|---|
| WebAssembly JavaScript Interface: Exception Handling> # dom-exception-exception> |