RTCPeerConnectionIceEvent: url property

The read-only url property of the RTCPeerConnectionIceEvent interface returns the URL of the STUN or TURN server used to gather the ICE candidate that caused the event. If the candidate was not gathered from a STUN or TURN server, the value is null.

[!NOTE] This property is considered deprecated by the specification in favor of the url property on the RTCIceCandidate interface itself.

Value

A string containing the URL of the STUN or TURN server used to gather this candidate, or null if the candidate was not gathered from a server (for example, a local host candidate).

Examples

Logging the ICE server URL

pc.onicecandidate = (event) => {
  if (event.candidate) {
    console.log(`Candidate gathered from: ${event.url}`);
  }
};

Specifications

Browser compatibility

See also

• icecandidate
• candidate
• RTCPeerConnection