Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

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

Parameter

tag

Eine WebAssembly.Tag-Instanz, die die erwarteten Datentypen für jeden Wert in payload definiert.

payload

Ein Array mit einem oder mehreren Datenfeldern, die die Nutzdaten der Ausnahme bilden. Die Elemente müssen den Datentypen der entsprechenden Elemente in tag entsprechen. Wenn die Anzahl oder die Typen der Datenfelder nicht übereinstimmen, wird eine TypeError-Ausnahme ausgelöst.

options Optional

Ein Objekt mit den folgenden optionalen Feldern:

traceStack Optional

true, wenn der Exception-Instanz ein Stacktrace in ihrer stack-Eigenschaft zugeordnet werden darf, andernfalls false. Der Standardwert ist false.

Ausnahmen

TypeError

Die Sequenzen payload und tag enthalten 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:

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

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

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

Browser-Kompatibilität

Siehe auch