W3cubDocs

/DOM Events

ended

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 in two related but unique contexts:

  • Elements based upon HTMLMediaElement (<audio> and <video>) fire ended when playback of the media reaches the end of the media.
  • Media strams' tracks, which are based on the MediaStreamTrack interface, fire ended when the track's source permanently stops sending data on the stream. There are various ways this can happen, including:
    • There is no more data left to send.
    • The user revoked the permissions needed for the data to be sent.
    • The hardware generating the source data has been removed or ejected.
    • A remote peer has permanently stopped sending data; pausing media does not generate an ended event.

General info

Specification
HTML5 media and Media Capture and Streams
Interface
Event
Bubbles
No
Cancelable
No
Target
Element
Default Action
None.

While this event is defined in two specifications, at this time both specify this event identically, so we have documented them as if they were one. If at some point that changes, the documentation will be revised.

Properties

Property Type Description
target Read only EventTarget The event target (the topmost target in the DOM tree).
type Read only DOMString The type of event.
bubbles Read only Boolean Whether the event normally bubbles or not
cancelable Read only Boolean Whether the event is cancellable or not?

© 2005–2017 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/Events/ended