RTCPeerConnectionIceEvent: url property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

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

Specifications

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcpeerconnectioniceevent-url

Browser compatibility

See also