HTMLMediaElement: ended event
The ended event is fired when playback or streaming has stopped because the end of the media was reached or because no further data is available.
This event occurs based upon HTMLMediaElement (<audio> and <video>) fire ended when playback of the media reaches the end of the media.
| Bubbles | No |
|---|---|
| Cancelable | No |
| Interface | Event |
| Target | Element |
| Default Action | None |
| Event handler property | GlobalEventHandlers.onended |
Note: This event is also defined in Media Capture and Streams and Web Audio API
Examples
These examples add an event listener for the HTMLMediaElement's ended event, then post a message when that event handler has reacted to the event firing.
Using addEventListener():
const video = document.querySelector('video'); video.addEventListener('ended', (event) => { console.log('Video stopped either because 1) it was over, ' + 'or 2) no further data is available.'); });
Using the onended event handler property:
const video = document.querySelector('video'); video.onended = (event) => { console.log('Video stopped either because 1) it was over, ' + 'or 2) no further data is available.'); };
Specifications
| Specification |
|---|
| HTML Standard (HTML) # event-media-ended |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ended_event |
3 |
12 |
3.5 |
9 |
10.5 |
3.1 |
≤37 |
18 |
4 |
Yes |
Yes |
1.0 |
Related Events
HTMLMediaElement: playing eventHTMLMediaElement: waiting eventHTMLMediaElement: seeking eventHTMLMediaElement: seeked eventHTMLMediaElement: ended eventHTMLMediaElement: loadedmetadata eventHTMLMediaElement: loadeddata eventHTMLMediaElement: canplay eventHTMLMediaElement: canplaythrough eventHTMLMediaElement: durationchange eventHTMLMediaElement: timeupdate eventHTMLMediaElement: play eventHTMLMediaElement: pause eventHTMLMediaElement: ratechange eventHTMLMediaElement: volumechange eventHTMLMediaElement: suspend eventHTMLMediaElement: emptied eventHTMLMediaElement: stalled event
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/ended_event