RTCIceCandidate.port

The RTCIceCandidate interface's read-only port property contains the port number on the device at the address given by RTCIceCandidate.address at which the candidate's peer can be reached.

The port field's value is set from the candidateInfo options object passed to the RTCIceCandidate() constructor. You can't specify the value of port directly in the options object, but its value is automatically extracted from the object's candidate a-line, if it's formatted properly.

Syntax

var port = RTCIceCandidate.port;

Value

A 16-bit number indicating the port number on the device at the address indicated by address at which the candidate's peer can be reached.

port is initialized to null if it is not specified in the candidate, or if the candidate string can't be parsed properly.

Note: If port is null, passing the candidate to addIceCandidate() will fail, throwing an OperationError exception. This applies only if the candidate implements port.

Usage notes

Consider this SDP attribute line (a-line) which describes an ICE candidate:

a=candidate:4234997325 1 udp 2043278322 192.168.0.56 44323 typ host

The port number is found in the sixth field, which is "44323". In this case, the value of port will be 44323.

Example

This code snippet fetches the IP address and port number of the candidate, storing them into an object for future use.

var candidateLoc = {
  address: candidate.ip,
  port: candidate.port
}

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
port
74
79
No
No
62
14.1
74
74
No
53
14.5
11.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCIceCandidate/port