WebAssembly.Exception 建構函式
**WebAssembly.Exception()** 建構函式用於建立新的 WebAssembly.Exception。
建構函式接受一個 Tag 引數和一個包含資料欄位的 payload 陣列。每個 payload 元素的資料型別必須與 Tag 中指定的對應資料型別匹配。
建構函式還可以接收一個 options 物件。options.traceStack 屬性可以設定為 true(預設情況下為 false),表示 Wasm 堆疊跟蹤可能附加到異常的 stack 屬性。
語法
js
new Exception(tag, payload)
new Exception(tag, payload, options)
引數
tag-
一個
WebAssembly.Tag,定義了payload中每個值預期的 資料型別。 payload-
一個包含一個或多個數據欄位的陣列,構成異常的
payload。元素必須與tag中對應元素的資料型別匹配。如果payload中的資料欄位數量及其型別不匹配,則會丟擲一個TypeError異常。 options可選 非標準-
一個包含以下可選欄位的物件
traceStack可選 非標準-
如果
Exception可能在其stack屬性中附加堆疊跟蹤,則為true,否則為false。預設情況下為false(如果未提供options或options.traceStack)。
異常
TypeError-
payload和tag序列沒有相同數量的元素,或元素的型別不匹配。
示例
此示例展示了使用簡單標籤建立異常的過程。
js
// 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]);
stack 示例 展示了使用 options 引數建立異常的過程。
規範
| 規範 |
|---|
| WebAssembly JavaScript 介面:異常處理 # dom-exception-exception |
瀏覽器相容性
BCD 表格僅在啟用 JavaScript 的瀏覽器中載入。