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 Mai 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 Elemente im payload müssen mit dem entsprechenden Datentyp übereinstimmen, der im Tag angegeben ist.
Der Konstruktor kann auch ein options-Objekt annehmen. 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
new Exception(tag, payload)
new Exception(tag, payload, options)
Parameter
tag-
Ein
WebAssembly.Tag, das die erwarteten Datentypen für jedes der Werte impayloaddefiniert. payload-
Ein Array von einem oder mehreren Datenfeldern, die das
payloadder Ausnahme bilden. Die Elemente müssen den Datentypen der entsprechenden Elemente imtagentsprechen. Wenn die Anzahl der Datenfelder impayloadund deren Typen nicht übereinstimmen, wird eineTypeError-Ausnahme ausgelöst. optionsOptional Nicht standardisiert-
Ein Objekt mit den folgenden optionalen Feldern:
traceStackOptional Nicht standardisiert-
true, wenn dieExceptionmöglicherweise einen Stack-Trace an ihrerstack-Eigenschaft haben kann, andernfallsfalse. Dies ist standardmäßigfalse(wennoptionsoderoptions.traceStacknicht bereitgestellt werden).
Ausnahmen
TypeError-
Die
payload- undtag-Sequenzen haben nicht die gleiche Anzahl von Elementen und/oder die Elemente sind nicht von übereinstimmenden Typen.
Beispiele
Dieses Beispiel zeigt die Erstellung einer Ausnahme mithilfe eines einfachen Tags.
// 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 Erstellung einer Ausnahme, die den options-Parameter verwendet.
Spezifikationen
| Specification |
|---|
| WebAssembly JavaScript Interface: Exception Handling # dom-exception-exception |