The MediaStream.onremovetrack
property is an EventHandler
which specifies a function to be called when the removetrack
event occurs on a MediaStream
instance. This happens when a track of any kind is removed from the media stream. This event is fired when the browser removes a track from the stream (such as when a RTCPeerConnection
is renegotiated or a stream being captured using HTMLMediaElement.captureStream()
gets a new set of tracks because the media element being captured loaded a new source.
The removetrack
event does not get fired when JavaScript code explicitly removes tracks from the stream (by calling removeTrack()
).
Syntax
MediaStream.onremovetrack = eventHandler;
Value
This should be set to a function which you provide that accepts as input a MediaStreamTrackEvent
object representing the removetrack
event which has occurred. The MediaStreamTrack
representing the track which was removed is specified in the event's track
property.
Example
This example adds a listener which, when a track is removed from the stream, logs the track that was removed.
stream.onremovetrack = function(event) {
let trackList = document.getElementById("tracks");
let label = document.createElement("li");
label.innerHTML = "Removed: " + event.track.kind + ": " + event.track.label;
trackList.appendChild(label);
};
Specifications
Specification | Status | Comment |
---|---|---|
Media Capture and StreamsThe definition of 'MediaStream.onremovetrack' 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 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
onremovetrack
|
Chrome
Full support 26 |
Edge
Full support 12 |
Firefox
No support No |
IE
No support No |
Opera
No support No |
Safari
Full support Yes |
WebView Android
Full support 37 |
Chrome Android
Full support 26 |
Firefox Android
No support No |
Opera Android
No support No |
Safari iOS
Full support Yes |
Samsung Internet Android
Full support 1.5 |
Legend
- Full support
- Full support
- No support
- No support
See also
- The
removetrack
event and its type,MediaStreamTrackEvent
.
MediaStream.onremovetrack by Mozilla Contributors is licensed under CC-BY-SA 2.5.