AudioWorkletNode:processorerror 事件

Baseline 已廣泛支援

此特性已得到良好支援,可在多種裝置和瀏覽器版本上使用。自 2021 年 4 月起,所有瀏覽器均已支援此特性。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

當節點背後的 AudioWorkletProcessor 在其建構函式、process 方法或任何使用者定義的類方法中丟擲異常時,會觸發 processorerror 事件。

一旦丟擲異常,處理器(以及節點)將在其整個生命週期內輸出靜默。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

js
addEventListener("processorerror", (event) => { })

onprocessorerror = (event) => { }

事件型別

一個通用的 Event

示例

要獲知處理器何時丟擲異常,您可以使用 addEventListener() 方法,為您的 AudioWorkletNode 例項新增一個處理程式,如下所示:

js
whiteNoiseNode.addEventListener("processorerror", (event) => {
  console.error("There was an error!");
});

或者,您也可以使用 onprocessorerror 事件處理程式屬性來設定 processorerror 事件的處理程式。

js
whiteNoiseNode.onprocessorerror = (event) => {
  console.error("There was an error!");
};

規範

規範
Web Audio API
# dom-audioworkletnode-onprocessorerror

瀏覽器相容性

另見