WebAssembly.Exception-Konstruktor

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2022.

Der WebAssembly.Exception()-Konstruktor wird verwendet, um eine neue WebAssembly.Exception zu erstellen.

Der Konstruktor akzeptiert ein Tag-Argument und ein payload-Array von Datenfeldern. Die Datentypen jedes der payload-Elemente müssen mit dem entsprechenden Datentyp übereinstimmen, der im Tag angegeben ist.

Der Konstruktor kann auch ein options-Objekt akzeptieren. Die options.traceStack-Eigenschaft kann auf true gesetzt werden (standardmäßig ist sie false), um anzugeben, dass ein Wasm-Stack-Trace an die stack-Eigenschaft der Ausnahme angehängt werden kann.

Syntax

js
new Exception(tag, payload)
new Exception(tag, payload, options)

Parameter

tag

Ein WebAssembly.Tag, das die erwarteten Datentypen für jedes der Werte im payload definiert.

payload

Ein Array von einem oder mehreren Datenfeldern, die die Nutzlast der Ausnahme bilden. Die Elemente müssen den Datentypen der entsprechenden Elemente im tag entsprechen. Wenn die Anzahl der Datenfelder im payload und deren Typen nicht übereinstimmen, wird eine TypeError-Ausnahme ausgelöst.

options Optional

Ein Objekt mit den folgenden optionalen Feldern:

traceStack Optional

true, wenn die Exception möglicherweise einen Stack-Trace an ihre stack-Eigenschaft angehängt haben kann, andernfalls false. Dies ist standardmäßig false (wenn options oder options.traceStack nicht angegeben sind).

Ausnahmen

TypeError

Die payload- und tag-Sequenzen haben nicht die gleiche Anzahl von Elementen und/oder die Elemente haben nicht übereinstimmende Typen.

Beispiele

Dieses Beispiel zeigt die Erzeugung einer Ausnahme mit einem einfachen Tag.

js
// 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]);

Das stack-Beispiel zeigt die Erzeugung einer Ausnahme, die den options-Parameter verwendet.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch