RTCIceCandidate.tcpType

The RTCIceCandidate interface's read-only tcpType property is included on TCP candidates to provide additional details about the candidate type.

The tcpType field's value is set when the RTCIceCandidate() constructor is used. You can't directly set its value; instead, its value is automatically extracted from the candidate a-line, if it's formatted properly.

Syntax

var tcpType = RTCIceCandidate.tcpType;

Value

A DOMString whose value is one of those defined by the RTCIceTcpCandidateType enumerated type.

"active"

The transport will try to open an outbound connection but won't receive inoming connection requests.

"passive"

The transport will receive incoming connection requests but won't try to open an outbound connection.

"so"

The transport will try to open a connection simultaneously with its peer.

tcpType is null for UDP candidates.

Example

In this example, the candidate's protocol and tcpType are used to adjust the user interface for simultaneous-open TCP candidates.

if (candidate.protocol == "tcp" && candidate.tcpType == "so") {
    adjustForSimultaneousOpen(candidate);
}

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See also

• WebRTC API
• Introduction to WebRTC protocols
• WebRTC connectivity
• RTCIceCandidate.protocol
• RTCIceCandidate.type