The read-only component property on the RTCIceCandidate interface is a string which indicates whether the candidate is an RTP or an RTCP candidate.

If a candidate represents both RTP and RTCP multiplexed together, it is considered to be an RTP candidate.


var component = RTCIceCandidate.component;


A DOMString which is "rtp" for RTP (or RTP and RTCP multiplexed together) candidates or "rtcp" for RTCP candidates.

Usage notes

Consider this SDP attribute line (a-line):

a=candidate:4234997325 1 udp 2043278322 44323 typ host

This is an ICE candidate a-line, whose foundation is 4234997325. The next field on the a-line, "1", is the component ID. A value of "1" indicates RTP, which is recorded in the component property as "rtp". If this value were instead "2", the a-line would be describing an RTCP candidate, and compoment would be "rtcp".


This code snippet examines a candidate's component type and dispatches the candidate to different handlers depending on the value.

if (candidate.component == "rtp") {
} else if (candidate.component == "rtcp") {
} else {


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

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support ? ? ? ? ? ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support ? ? ? ? ? ? ?

Document Tags and Contributors

Contributors to this page: Sheppy
Last updated by: Sheppy,