canTrickleIceCandidates property

bool? get canTrickleIceCandidates

The canTrickleIceCandidates read-only property of the RTCPeerConnection interface returns a boolean value which indicates whether or not the remote peer can accept trickled ICE candidates.

ICE trickling is the process of continuing to send candidates after the initial offer or answer has already been sent to the other peer.

This property is only set after having called RTCPeerConnection.setRemoteDescription. Ideally, your signaling protocol provides a way to detect trickling support, so that you don't need to rely on this property. A WebRTC browser will always support trickle ICE. If trickling isn't supported, or you aren't able to tell, you can check for a falsy value for this property and then wait until the value of RTCPeerConnection.iceGatheringState changes to "completed" before creating and sending the initial offer. That way, the offer contains all of the candidates.

Implementation

external bool? get canTrickleIceCandidates;