AudioWorkletNode: processorerror イベント
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2021年4月以降、すべてのブラウザーで利用可能です。
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("エラーが発生しました！");
};
仕様書
| 仕様書 |
|---|
| Web Audio API # dom-audioworkletnode-onprocessorerror |