HTMLMediaElement: ended イベント

Baseline Widely available

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

ended イベントは、メディアの終わりに達したため、またはそれ以上利用できるデータがないために再生またはストリーミングが停止したときに発生します。

このイベントは、 HTMLMediaElement（<audio> および <video>）においてメディアの再生がメディアの最後に到達して終了した時に、 ended が発生します。

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

メモ: ended イベントは loop プロパティが true で playbackRate が負の数ではない場合には発生しません。

構文

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

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

onended = (event) => {};

イベント型

一般的な Event です。

例

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

addEventListener() を使用する場合:

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

video.addEventListener("ended", (event) => {
  console.log(
    "動画は再生が完了したか、それ以上のデータが利用できないために停止しました。",
  );
});

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

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

video.onended = (event) => {
  console.log(
    "動画は再生が完了したか、それ以上のデータが利用できないために停止しました。",
  );
};

仕様書

Specification
HTML Standard
# event-media-ended
HTML Standard
# handler-onended

ブラウザーの互換性

BCD tables only load in the browser

関連イベント

関連情報