AudioWorkletNode: processorerror イベント

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

関連情報