AudioScheduledSourceNode: ended イベント

Baseline Widely available

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

ended は AudioScheduledSourceNode インターフェイスのイベントで、ソースノードの再生が停止したときに発生します。

このイベントは、AudioScheduledSourceNode の再生が停止したときに発生します。理由は、所定の停止時刻に達したか、音声の全時間が再生されたか、またはバッファーの全体が再生されたかのいずれかです。

このイベントはキャンセル不可で、バブリングしません。

構文

このイベント名を addEventListener() 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

addEventListener("ended", (event) => { })

onended = (event) => { }

一般的な Event です。

この単純な例では、 ended イベントに対するイベントリスナーを設定し、ノードの再生が停止したときにユーザーインターフェイスに［Start］ボタンを表示できるようにしています。

node.addEventListener("ended", () => {
  document.getElementById("startButton").disabled = false;
});

また、 onended プロパティを使用してイベントハンドラーを設定することもできます。

node.onended = () => {
  document.getElementById("startButton").disabled = false;
};

ended イベントの使用例は、 audio-buffer の例 (GitHub) を参照してください。

Specification
Web Audio API # dom-audioscheduledsourcenode-onended