W3cubDocs

/Web APIs

RTCPeerConnectionIceEvent

The RTCPeerConnectionIceEvent interface represents events that occur in relation to ICE candidates with the target, usually an RTCPeerConnection.

Only one event is of this type: icecandidate.

A RTCPeerConnectionIceEvent being an Event, this event also implements these properties.

RTCPeerConnectionIceEvent.candidate Read only: Contains the RTCIceCandidate containing the candidate associated with the event, or null if this event indicates that there are no further candidates to come.

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

A RTCPeerConnectionIceEvent being an Event, this event also implements these properties. There is no specific RTCDataChannelEvent method.

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

Specification
WebRTC: Real-Time Communication in Browsers # rtcpeerconnectioniceevent

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`RTCPeerConnectionIceEvent`	56	15	24	No	43	12	56	56	24	43	12	6.0
`RTCPeerConnectionIceEvent`	5624–56	15	24	No	4315–43	12	564.4–56	5625–56	24	4314–43	12	6.01.5–6.0
`candidate`	24	15	24	No	15	12	4.4	25	24	14	12	1.5
`url`	No	No	No	No	No	12	No	No	No	No	12	No