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 プロパティが trueplaybackRate が負の数ではない場合には発生しません。

構文

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

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

onended = (event) => {};

イベント型

一般的な Event です。

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

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
# event-media-ended
HTML
# handler-onended

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
ended event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

関連イベント

関連情報