Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Avoid using it and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The removestream event has been removed from the WebRTC specification in favor of the existing removetrack event on the remote MediaStream and the corresponding MediaStream.onremovetrack event handler property of the remote MediaStream. The RTCPeerConnection API is now track-based, so having zero tracks in the remote stream is equivalent to the remote stream being removed and the old removestream event.
The RTCPeerConnection.onremovestream event handler is a property containing the code to execute when the removestream event, of type MediaStreamEvent, is received by this RTCPeerConnection. Such an event is sent when a MediaStream is removed from this connection.
Syntax
peerconnection.onremovestream = function;
Values
functionis the name of a user-defined function, without the()suffix or any parameters, or an anonymous function declaration, such asfunction(event) {...}. An event handler always has one single parameter, containing the event, here of typeMediaStreamEvent.
Example
pc.onremovestream = function(ev) { alert("onremovestream event detected!"); };
Specifications
| Specification | Status | Comment |
|---|---|---|
| WebRTC 1.0: Real-time Communication Between Browsers The definition of 'RTCPeerConnection.onremovestream' in that specification. |
Candidate Recommendation | Initial specification. |
Browser compatibility
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
| Basic support | Chrome Full support 56 | Edge Full support 15 | Firefox No support 22 — 60 | IE ? | Opera
Full support
43
| Safari ? | WebView Android Full support 56 | Chrome Android Full support 56 | Edge Mobile Full support Yes | Firefox Android No support 44 — 60 | Opera Android
Full support
43
| Safari iOS ? | Samsung Internet Android Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.
- See implementation notes.
- See implementation notes.
See also
- The
removestreamevent and its type,MediaStreamEvent.