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
Specification HTML5 media

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 Status
HTML Living Standard
The definition of 'ended media event' in that specification.
Living Standard
HTML5
The definition of 'ended media event' in that specification.
Recommendation

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
ended eventChrome Full support 3Edge Full support 12Firefox Full support 3.5IE Full support 9Opera Full support 10.5Safari Full support 3.1WebView Android Full support YesChrome Android Full support 18Firefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support 1.0

Legend

Full support
Full support

See Also