The stop() method in the RTCRtpTransceiver interface permanently stops the transceiver by stopping both the associated RTCRtpSender and RTCRtpReceiver.
On this page
RTCRtpTransceiver: stop() method
Syntax
js
stop()
Parameters
None.
Return value
None (undefined).
Exceptions
InvalidStateErrorDOMException-
Thrown if the
RTCPeerConnection, of which the transceiver is a member, is closed.
Description
When you call stop() on a transceiver, the sender immediately stops sending media and each of its RTP streams are closed using the RTCP "BYE" message. The receiver then stops receiving media; the receiver's track is stopped, and the transceiver's direction is changed to stopped. Renegotiation is triggered by sending a negotiationneeded event to the transceiver's RTCPeerConnection, so that the connection can adapt to the change.
The method does nothing if the transceiver is already stopped. You can check whether it has stopped by comparing currentDirection to "stopped".
Note: Earlier versions of the specification used the deprecated stopped Deprecated property to indicate if the transceiver has stopped.
Specifications
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
stop |
88 | 88 | 59 | No | 74 | 11 | 88 | 88 | 59 | 63 | 11 | 15.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCRtpTransceiver/stop