RTCPeerConnectionIceEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.

TheRTCPeerConnectionIceEvent interface represents events that occur in relation toICE candidates with the target, usually anRTCPeerConnection.

Only one event is of this type:icecandidate.

Instance properties

ARTCPeerConnectionIceEvent being anEvent, this event also implements these properties.

RTCPeerConnectionIceEvent.candidateRead only: Contains theRTCIceCandidate containing the candidate associated with the event, ornull if this event indicates that there are no further candidates to come.
RTCPeerConnectionIceEvent.urlRead onlyDeprecated: Contains a string indicating the URL of the STUN orTURN server used to gather the candidate, ornull if the candidate was not gathered from a server.

RTCPeerConnectionIceEvent(): Returns a newRTCPeerConnectionIceEvent. It takes two parameters, the first being a string representing the type of the event; the second a dictionary containing theRTCIceCandidate it refers to.

ARTCPeerConnectionIceEvent being anEvent, this event also implements these properties. There is no specificRTCDataChannelEvent method.

pc.onicecandidate = (ev) => {  console.log(    `The ICE candidate ('${ev.candidate.candidate}') added to connection.`,  );};

Specification
WebRTC: Real-Time Communication in Browsers # rtcpeerconnectioniceevent

This page was last modified onFeb 13, 2026 byMDN contributors.