WebAssembly.Exception.prototype.is()

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.

Die is() Prototyp-Methode des Exception-Objekts kann verwendet werden, um zu testen, ob die Exception mit einem gegebenen Tag übereinstimmt.

Die Methode kann verwendet werden, um zu testen, ob ein Tag korrekt ist, bevor es an Exception.prototype.getArg() übergeben wird, um die übergebenen Werte zu erhalten. Sie kann auf Tags angewendet werden, die in JavaScript erstellt oder in WebAssembly-Code erstellt und nach JavaScript exportiert wurden.

Hinweis: Es ist nicht ausreichend, dass das Tag eine identische Sequenz von Datentypen hat — es muss dieselbe Identität haben (dasselbe Tag sein), die verwendet wurde, um die Ausnahme zu erstellen.

Syntax

js
is(tag)

Parameter

tag

Ein WebAssembly.Tag, das überprüft werden kann, um den Typ der Ausnahme zu verifizieren.

Rückgabewert

Ein Boolean true, wenn das angegebene Tag mit der Ausnahme übereinstimmt, andernfalls false.

Beispiele

Der folgende Code zeigt, wie is() verwendet wird, um zu überprüfen, ob ein Tag mit einer Exception übereinstimmt.

js
// Create tag and use it to create an exception
const tag1 = new WebAssembly.Tag({ parameters: ["i32", "f64"] });
const exception1 = new WebAssembly.Exception(tag1, [42, 42.3]);

// Verify that "tag1" matches this exception
console.log(`Tag1: ${exception1.is(tag1)}`);

// Log output:
// Tag1: true

Wir können auch demonstrieren, dass diese Ausnahme nicht mit einem anderen Tag übereinstimmen wird, selbst wenn das Tag mit denselben Parametern erstellt wird.

js
// Create a new tag (with same parameters) and verify it does not match the exception
const tag2 = new WebAssembly.Tag({ parameters: ["i32", "f64"] });
console.log(`Tag2: ${exception1.is(tag2)}`);

// Log output:
// Tag2: false

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch