Deprecated
This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. 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 RTCPeerConnection.removeStream()
method removes a MediaStream
as a local source of audio or video. If the negotiation already happened, a new one will be needed for the remote peer to be able to use it. Because this method has been deprecated, you should instead use removeTrack()
if your target browser versions have implemented it.
If the signalingState
is set to "closed"
, an InvalidStateError
is raised. If the signalingState
is set to "stable"
, the event negotiationneeded
is sent on the RTCPeerConnection
.
Syntax
RTCPeerConnection.removeStream(mediaStream);
Parameters
mediaStream
- A
MediaStream
specifying the stream to remove from the connection.
Return value
Example
var pc, videoStream; navigator.getUserMedia({video: true}, function(stream) { pc = new RTCPeerConnection(); videoStream = stream; pc.addStream(stream); } document.getElementById("closeButton").addEventListener("click", function(event) { pc.removeStream(videoStream); pc.close(); }, false);
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
removeStream | Chrome Full support 24 | Edge Full support 15 | Firefox No support 22 — 51 | IE No support No | Opera
Full support
43
| Safari ? | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 44 | Opera Android
Full support
43
| Safari iOS No support 11 — 12 | Samsung Internet Android Full support 6.0 |
Legend
- Full support
- Full support
- No support
- No support
- Compatibility unknown
- Compatibility unknown
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
- Deprecated. Not for use in new websites.
- Deprecated. Not for use in new websites.
- See implementation notes.
- See implementation notes.