--- title: 'HTMLMediaElement: ended イベント' slug: Web/API/HTMLMediaElement/ended_event tags: - Audio - HTML DOM - HTMLMediaElement - Media - Media Streams API - Reference - Video - Web Audio API - ended - events translation_of: Web/API/HTMLMediaElement/ended_event ---
{{APIRef("HTMLMediaElement")}}
ended イベントは、メディアの終わりに達したため、またはそれ以上利用できるデータがないために再生またはストリーミングが停止したときに発生します。 このイベントは、メディアの再生がメディアの最後に到達して終了した {{domxref("HTMLMediaElement")}}({{HTMLElement("audio")}} および {{HTMLElement("video")}})に基づいて発生します。
| バブリング | なし |
|---|---|
| キャンセル | 不可 |
| インターフェイス | {{DOMxRef("Event")}} |
| 対象 | 要素 |
| 既定のアクション | なし |
| イベントハンドラプロパティ | {{domxref("GlobalEventHandlers.onended")}} |
| 仕様 | HTML5 メディア |
このイベントは、Media Capture and Streams API および Web Audio API でも定義されています。
これらの例では、HTMLMediaElement の ended イベントのイベントリスナーを追加し、そのイベントハンドラがイベントの発生に反応したときにメッセージを投稿します。
AddEventListener() を使用する場合
const video = document.querySelector('video');
video.addEventListener('ended', (event) => {
console.log('1)動画が終了した、または 2)それ以上データがない' +
'ため、動画が停止しました。');
});
onended イベントハンドラプロパティを使用する場合
const video = document.querySelector('video');
video.onended = (event) => {
console.log('1)動画が終了した、または 2)それ以上データがない' +
'ため、動画が停止しました。');
};
| 仕様 | 状態 |
|---|---|
| {{SpecName('HTML WHATWG', "media.html#event-media-ended", "ended media event")}} | {{Spec2('HTML WHATWG')}} |
| {{SpecName('HTML5 W3C', "embedded-content-0.html#event-media-ended", "ended media event")}} | {{Spec2('HTML5 W3C')}} |
{{Compat("api.HTMLMediaElement.ended_event")}}