RTCPeerConnection: removestream event

{{APIRef("WebRTC")}}{{Deprecated_Header}}{{Non-standard_Header}}

The obsolete removestream event was sent to an {{domxref("RTCPeerConnection")}} to inform it that a {{domxref("MediaStream")}} had been removed from the connection. You can use the RTCPeerConnection interface's onremovestream property to set a handler for this event.

This is the counterpart to the {{domxref("RTCPeerConnection.addstream_event", "addstream")}} event, which is also obsolete.

[!WARNING] This event has been removed from the WebRTC specification in favor of the existing {{DOMxRef("MediaStream/removetrack_event", "removetrack")}} event on the remote {{domxref("MediaStream")}} and the corresponding event handler property of the remote {{domxref("MediaStream")}}. The {{domxref("RTCPeerConnection")}} API is now track-based, so having zero tracks in the remote stream is equivalent to the remote stream being removed, which caused a removestream event.

This event is not cancelable and does not bubble.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

addEventListener("removestream", (event) => { })

onremovestream = (event) => { }

Event type

A {{domxref("MediaStreamEvent")}}. Inherits from {{domxref("Event")}}.

{{InheritanceDiagram("MediaStreamEvent")}}

Event properties

A {{domxref("MediaStreamEvent")}} being an {{domxref("Event")}}, this event also implements these properties.

• {{domxref("MediaStreamEvent.stream")}} {{ReadOnlyInline}}
  • : Contains the {{domxref("MediaStream")}} containing the stream associated with the event.

Browser compatibility

{{Compat}}

See also

• WebRTC API
• {{domxref("RTCPeerConnection.removeStream()")}}
• {{domxref("MediaStream.removetrack_event", "removetrack")}}