WebAssembly.Exception.prototype.is()

Baseline 已廣泛支援

此功能已成熟,並可在許多裝置和瀏覽器版本上使用。自 2022 年 5 月以來,它已在各個瀏覽器中可用。

is() 建構函式方法可用於測試一個 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

瀏覽器相容性

另見