The read-only RTCIceTransport property role indicates which ICE role the transport is fulfilling: that of the controlling agent, or the agent that is being controlled.

You can learn more about ICE roles in Choosing a candidate pair in WebRTC connectivity.


iceRole = RTCIceTransport.role;


A DOMString specifying whether the RTCIceTransport represents the controlling agent or the controlled agent. The value must be one of those found in the enumerated type RTCIceRole:

The RTCIceTransport object is serving as the controlling agent.
The transport is the controlled agent.


Specification Status Comment
WebRTC 1.0: Real-time Communication Between BrowsersThe definition of 'RTCIceTransport.role' in that specification. Candidate Recommendation Initial definition.

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
role Chrome

No support No


No support 15 — 79


No support No


No support No


No support No


No support No

WebView Android

No support No

Chrome Android

No support No

Firefox Android

No support No

Opera Android

No support No

Safari iOS

No support No

Samsung Internet Android

No support No


No support  
No support