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