WebAssembly.Exception.prototype.is()

is()Exception 物件的原型方法,可用於測試 Exception 是否與給定的標籤匹配。

此方法可用於在將標籤傳遞給 Exception.prototype.getArg() 以獲取傳遞的值之前,驗證標籤是否正確。它可用於在 JavaScript 中建立的標籤,也可用於在 WebAssembly 程式碼中建立並匯出到 JavaScript 的標籤。

注意:僅標籤具有相同的型別資料序列是不夠的——它必須具有與用於建立異常的標籤相同的標識(是同一個標籤)。

語法

js
is(tag)

引數

tag

一個 WebAssembly.Tag,用於檢查異常的型別。

返回值

如果指定的標籤與異常匹配,則返回布林值 true,否則返回 false

示例

以下程式碼演示瞭如何使用 is() 驗證標籤是否與 Exception 匹配。

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

我們還可以證明,即使使用相同的引數建立標籤,此異常也不會與另一個標籤匹配。

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

規範

規範
WebAssembly JavaScript 介面:異常處理
# dom-exception-is

瀏覽器相容性

BCD 表僅在啟用 JavaScript 的瀏覽器中載入。

另請參閱