HTMLMediaElement: stalled イベント

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

stalled イベントは、ユーザーエージェントがメディアデータをフェッチしようとして、データが予期せずに来なかったときに発生します。

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

構文

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

addEventListener("stalled", (event) => {});

onstalled = (event) => {};

一般的な Event です。

これらの例では、HTMLMediaElement の stalled イベントのイベントリスナーを追加し、そのイベントハンドラーがイベントの発生に反応したときにメッセージを投稿します。

addEventListener() を使用する場合:

const video = document.querySelector("video");

video.addEventListener("stalled", (event) => {
  console.log("データのフェッチに失敗しました。");
});

onstalled イベントハンドラープロパティを使用する場合:

const video = document.querySelector("video");

video.onstalled = (event) => {
  console.log("データのフェッチに失敗しました。");
};

仕様書
HTML # event-media-stalled
HTML # handler-onstalled

このページは MDN の貢献者によって 2024年8月5日に最終更新されました。