The MediaStreamTrack.onended
event handler is used to specify a function which serves as an EventHandler
to be called when the ended
event occurs on the track. This event occurs when the track will no longer provide data to the stream for any reason, including the end of the media input being reached, the user revoking needed permissions, the source device being removed, or the remote peer ending a connection.
Syntax
MediaStreamTrack.onended = function;
Value
A function to serve as an EventHandler
for the ended
event. The event handler function receives a single parameter: the event object, which is a simple Event
object.
Examples
This example sets up an event handler for the ended
event which changes an on-screen icon to indicate that the track is no longer active.
track.onended = function(event) { let statusElem = document.getElementById("status-icon"); statusElem.src = "/images/stopped-icon.png"; }
Specifications
Specification | Status | Comment |
---|---|---|
Media Capture and Streams The definition of 'MediaStreamTrack.onended' in that specification. |
Candidate Recommendation | Initial specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
onended | Chrome Full support Yes | Edge Full support 12 | Firefox Full support 50 | IE No support No | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 50 | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- No support
- No support