AudioWorkletNode: processorerror イベント

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

processorerror イベントは、ノードで用いている AudioWorkletProcessor がコンストラクターか、process メソッドか、ユーザー定義のクラスメソッドのどれかで例外を投げた時発火します。

例外が投げられた後は、処理器 (そして対応するノード) はずっと無音を出力します。

構文

addEventListener() のようなメソッドでイベント名を用いるか、イベントハンドラープロパティを設定します。

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

onprocessorerror = (event) => { }

イベント型

汎用の Event です。

例

処理器が例外を投げたことの通知を受け取るため、以下のように、addEventListener() を用いて AudioWorkletNode のインスタンスにハンドラーを追加できます。

js
whiteNoiseNode.addEventListener("processorerror", (event) => {
  console.error("エラーが発生しました！");
});

別の方法として、processorerror イベントのハンドラーを設定するために onprocessorerror イベントハンドラープロパティを用いることもできます。

js
whiteNoiseNode.onprocessorerror = (event) => {
  console.error("エラーが発生しました！");
};

仕様書

Specification
Web Audio API
# dom-audioworkletnode-onprocessorerror

ブラウザーの互換性

BCD tables only load in the browser

関連情報