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 StreamsThe 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.
Update compatibility data on GitHub
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
See also
- The
ended
event and its type,Event
.
MediaStreamTrack.onended by Mozilla Contributors is licensed under CC-BY-SA 2.5.