Syntax

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

Parameter

tag

Eine Instanz von WebAssembly.Tag, die die erwarteten Datentypen für jeden der Werte im payload definiert.

payload

Ein Array aus einem oder mehreren Datenfeldern, die die Nutzdaten 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 in ihrer stack-Eigenschaft angehängt hat, andernfalls false. Standardmäßig false.

Ausnahmen

TypeError

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

Beschreibung

Der Exception()-Konstruktor akzeptiert einen WebAssembly.Tag, ein Array von Werten und ein options-Objekt als Argumente. Der Tag definiert eindeutig den Typ einer Ausnahme, einschließlich der Reihenfolge seiner Argumente und deren Datentypen. Derselbe Tag, der verwendet wurde, um die Exception zu erstellen, ist erforderlich, um die Argumente einer ausgelösten Ausnahme zuzugreifen (mittels Exception.prototype.getArg()).

Beispiele

Grundlegende Verwendung

Normalerweise würden Sie diesen Konstruktor nicht verwenden, um manuell eine Wasm-Ausnahme zu erstellen. Stattdessen wird ein WebAssembly.Exception-Objekt normalerweise erstellt, wenn Wasm-Ausnahmen behandelt werden, zum Beispiel:

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
      }
    }
  },
);

Für ein funktionierendes Beispiel siehe die Referenzseite zur throw-Anweisung.

Manuelle Verwendung

Dieses Beispiel zeigt die manuelle Erstellung einer WebAssembly.Exception-Instanz.

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• WebAssembly-Übersicht
• WebAssembly-Konzepte
• Verwendung der WebAssembly JavaScript API