W3cubDocs

removestream

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 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 removestream event indicates that a MediaStream has been removed from the RTCPeerConnection which received the event. You can use the RTCPeerConnection interface's onremovestream property to set a handler for this event.

General info

Specification: WebRTC 1.0: Real-time Communication Between Browsers
The definition of 'removestream' in that specification.
Interface: MediaStreamEvent
Bubbles: No
Cancelable: No
Target: RTCPeerConnection
Default Action: None

Properties

Since MediaStreamEvent is based on Event, this event also implements its properties.

stream Read only: The MediaStream that has been removed from the target.

Methods

Since MediaStreamEvent is based on Event, this event also implements its methods. There are no specific MediaStreamEvent methods.

Related events

addstream

Specifications

Specification	Status	Comment
WebRTC 1.0: Real-time Communication Between Browsers The definition of 'removestream' in that specification.	Candidate Recommendation

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari
Basic support	(Yes)	(Yes)	18 (18) [1] Removed in Firefox 60	No support	(Yes)	?

Feature	Android	Chrome for Android	Edge	Firefox Mobile (Gecko)	IE Mobile	Opera Mobile	Safari Mobile
Basic support	?	?	(Yes)	18 (18) [1] Removed in Firefox 60	No support	?	?

[1] This event was introduced in Firefox 18, but was removed outright in Firefox 60. As of Firefox 59, you can use the onremovetrack property of the remote MediaStream instead, and check when the number of tracks in the stream go to zero. Be aware that having zero sending tracks and no data channel may cause ICE failure in Firefox 58 and earlier.