RTCRtpTransceiver.currentDirection

The read-only RTCRtpTransceiver property currentDirection is a string which indicates the current directionality of the transceiver. Its value is one of the strings defined by the RTCRtpTransceiverDirection enumeration.

You can examine and set the transceiver's preferred directionality using direction property.

Syntax

var direction = RTCRtpTransceiver.currentDirection

Value

A DOMString whose value is one of the strings which are a member of the RTCRtpTransceiverDirection enumerated type.

The RTCRtpTransceiverDirection type is an enumeration of string values. Each describes how the transceiver's associated RTCRtpSender and RTCRtpReceiver behave as shown in the table below.

Value	`RTCRtpSender` behavior	`RTCRtpReceiver` behavior
`"sendrecv"`	Offers to send RTP data, and will do so if the other peer accepts the connection and at least one of the sender's encodings is active¹.	Offers to receive RTP data, and does so if the other peer accepts.
`"sendonly"`	Offers to send RTP data, and will do so if the other peer accepts the connection and at least one of the sender's encodings is active¹.	Does not offer to receive RTP data and will not do so.
`"recvonly"`	Does not offer to send RTP data, and will not do so.	Offers to receive RTP data, and will do so if the other peer offers.
`"inactive"`	Does not offer to send RTP data, and will not do so.	Does not offer to receive RTP data and will not do so.

[1] To determine if a sender has at least one active encoding, the user agent gets its parameters using RTCRtpSender.getParameters(), then looks at the parameters' encodings property; if any of the listed encodings has its active property set to true, the sender has an active encoding.

Specifications

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

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`currentDirection`	Chrome No support No	Edge ?	Firefox Full support 59	IE No support No	Opera No support No	Safari ?	WebView Android No support No	Chrome Android No support No	Firefox Android Full support 59	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown