RTCIceCandidatePairStats

このロケールの翻訳が存在しないため、英語バージョンのコンテンツを表示しています。 Help us translate this article!

The WebRTC RTCIceCandidatePairStats dictionary reports statistics which provide insight into the quality and performance of an RTCPeerConnection while connected and configured as described by the specified pair of ICE candidates.

If a RTCStats-based object's type is candidate-pair, it's an RTCIceCandidatePairStats object.

Properties

RTCIceCandidatePairStats is based upon RTCStats and inherits its properties. In addition, it adds the following new properties:

availableIncomingBitrate Optional
Provides an informative value representing the available inbound capacity of the network by reporting the total number of bits per second available for all of the candidate pair's incoming RTP streams. This does not take into account the size of the IP overhead, nor any other transport layers such as TCP or UDP.
availableOutgoingBitrate Optional
Provides an informative value representing the available outbound capacity of the network by reporting the total number of bits per second available for all of the candidate pair's outoing RTP streams. This does not take into account the size of the IP overhead, nor any other transport layers such as TCP or UDP.
bytesReceieved Optional
The total number of payload bytes received (that is, the total number of bytes received minus any headers, padding, or other administrative overhead) on this candidate pair so far.
bytesSent Optional
The total number of payload bytes sent (that is, the total number of bytes sent minus any headers, padding, or other administrative overhead) so far on this candidate pair.
circuitBreakerTriggerCount Optional
An integer value indicating the number of times the circuit-breaker has been triggered for this particular 5-tuple (the set of five values comprising a TCP connection: source IP address, source port number, destination IP address, destination port number, and protocol). The circuit breaker is triggered whenever a connection times out or otherwise needs to be automatically aborted.
consentExpiredTimestamp Optional
A DOMHighResTimeStamp value indicating the time at which the most recent STUN binding response expired. This value is undefined if no valid STUN binding responses have been sent on the candidate pair; this can only happen if responsesReceived is 0.
consentRequestsSent Optional
The total number of consent requests that have been sent on this candidate pair.
currentRoundTripTime Optional
A floating-point value indicating the total time, in seconds, that elapsed elapsed between the most recently-sent STUN request and the response being received. This may be based upon requests that were involved in confirming permission to open the connection.
firstRequestTimestamp Optional
A DOMHighResTimeStamp value which specifies the time at which the first STUN request was sent from the local peer to the remote peer for this candidate pair.
lastPacketReceivedTimestamp Optional
A DOMHighResTimeStamp value indicating the time at which the last packet was received by the local peer from the remote peer for this candidate pair. Timestamps are not recorded for STUN packets.
lastPacketSentTimestamp Optional
A DOMHighResTimeStamp value indicating the time at which the last packet was sent from the local peer to the remote peer for this candidate pair. Timestamps are not recorded for STUN packets.
lastRequestTimestamp Optional
A DOMHighResTimeStamp value which specifies the time at which the last (most recent) STUN request was sent from the local peer to the remote peer for this candidate pair.
lastResponseTimestamp Optional
A DOMHighResTimeStamp value that specifies the time at which the last (most recent) STUN response was received by the local candidate from the remote candidate in this pair.
localCandidateId Optional
The unique ID string corresponding to the RTCIceCandidate from the data included in the RTCIceCandidateStats object providing statistics for the candidate pair's local candidate.
nominated Optional
A Boolean value which, if true, indicates that the candidate pair described by this object is one which has been proposed for use, and will be (or was) used if its priority is the highest among the nominated candidate pairs. See RFC 5245, section 7.1.3.2.4 for details.
packetsReceived Optional
The total number of packets received on this candidate pair.
packetsSent Optional
The total number of packets sent on this candidate pair.
remoteCandidateId Optional
The unique ID string corresponding to the remote candidate from which data was taken to construct the RTCIceCandidateStats object describing the remote end of the connection.
requestsReceived Optional
The total number of connectivity check requests that have been received, including retransmissions. This value includes both connectivity checks and STUN consent checks.
requestsSent Optional
The total number of connectivity check requests that have been sent, not including retransmissions.
responsesReceived Optional
The total number of connectivity check responses that have been received.
responsesSent Optional
The total number of connectivity check responses that have been sent. This includes both connectivity check requests and STUN consent requests.
retransmissionsReceived Optional
The total number of times connectivity check request retransmissions were received. A retransmission is a connectivity check request whose TRANSACTION_TRANSMIT_COUNTER attribute's req field is greater than 1.
retransmissionsSent Optional
The total number of times connectivity check request retransmissions were sent.
state Optional
A RTCStatsIceCandidatePairState object which indicates the state of the connection between the two candidates.
totalRoundTripTime Optional
A floating-point value indicating the total time, in seconds, that has elapsed between sending STUN requests and receiving responses to them, for all such requests made to date on this candidate pair. This includes botyh connectivity check and consent check requests. You can compute the average round trip time (RTT) by dividing this value by responsesReceived.
transportId Optional
A DOMString that uniquely identifies the RTCIceTransport that was inspected to obtain the transport-related statistics (as found in RTCTransportStats) used in generating this object.

Obsolete properties

The following properties have been removed from the specification and should no longer be used. You should update any existing code to avoid using them as soon as is practical. Check the compatibility table for details on which browsers support them and in which versions.

priority Optional
An integer value indicating the candidate pair's priority.
readable Optional
A Boolean value indicating whether or not data can be sent over the connection described by the candidate pair.
writable Optional
A Boolean value indicating whether or not data can be received on the connection described by the candidate pair.

Non-standard properties

selected Optional
A Firefox-specific Boolean value which is true if the candidate pair described by this object is the one currently in use. The spec-compliant way to determine the selected candidate pair is to look for a stats object of type transport, which is an RTCTransportStats object. That object's selectedCandidatePairId property indicates whether or not the specified transport is the one being used.

Usage notes

The currently-active ICE candidate pair—if any—can be obtained by calling the RTCIceTransport method getSelectedCandidatePair(), which returns an RTCIceCandidatePair object, or null if there isn't a pair selected. The active candidate pair describes the current configuration of the two ends of the RTCPeerConnection.

Any candidate pair that isn't the active pair of candidates for a transport gets deleted if the RTCIceTransport performs an ICE restart, at which point the state of the ICE transport returns to new and negotiation starts once again. For more information, see ICE restart in Lifetime of a WebRTC session.

Example

This example computes the average time elapsed between connectivity checks if the RTCStats object rtcStats is an RTCIceCandidatePairStats object.

if (rtcStats && rtcStats.type === "candidate-pair") {
  let elapsed = (rtcStats.lastRequestTimestamp - rtcStats.firstRequestTimestamp)
                  / rtcStats.requestsSent;

  log("Average time between ICE connectivity checks: " + elapsed + " ms.");
}

The code begins by looking at rtcStats to see if its type is candidate-pair. If it is, then we know that rtcStats is in fact an RTCIceCandidatePairStats object. If so, we compute the average time elapsed between STUN connectivity checks and log that information.

Specifications

Specification Status Comment
Identifiers for WebRTC's Statistics API
The definition of 'RTCIceCandidatePairStats' in that specification.
Candidate Recommendation Initial specification.

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
RTCIceCandidatePairStatsChrome Full support 56Edge ? Firefox Full support 29IE No support NoOpera ? Safari ? WebView Android Full support 56Chrome Android Full support 56Firefox Android Full support 29Opera Android ? Safari iOS ? Samsung Internet Android ?
availableIncomingBitrateChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
availableOutgoingBitrateChrome Full support YesEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
bytesReceivedChrome Full support YesEdge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android ?
bytesSentChrome Full support YesEdge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android ?
circuitBreakerTriggerCountChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
consentExpiredTimestampChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
contentRequestsSentChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
currentRoundTripTimeChrome Full support 71
Full support 71
Full support Yes
Alternate Name
Alternate Name Uses the non-standard name: currentRtt
Edge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support 71
Full support 71
Full support Yes
Alternate Name
Alternate Name Uses the non-standard name: currentRtt
Firefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android ?
firstRequestTimeStampChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
lastPacketReceivedTimestampChrome No support NoEdge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android No support No
lastPacketSentTimestampChrome No support NoEdge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android No support No
lastReponseTimestampChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
lastRequestTimestampChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
localCandidateIdChrome No support NoEdge ? Firefox Full support 29IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 29Opera Android ? Safari iOS ? Samsung Internet Android No support No
nominatedChrome No support NoEdge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android No support No
packetsReceivedChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
packetsSentChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
priority
Non-standard
Chrome No support NoEdge ? Firefox Full support 42
Full support 42
Full support 29
Alternate Name
Alternate Name Uses the non-standard name: mozPriority
IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 42
Full support 42
Full support 29
Alternate Name
Alternate Name Uses the non-standard name: mozPriority
Opera Android ? Safari iOS ? Samsung Internet Android No support No
readable
Non-standard
Chrome No support NoEdge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android No support No
remoteCandidateIdChrome No support NoEdge ? Firefox Full support 29IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 29Opera Android ? Safari iOS ? Samsung Internet Android No support No
requestsReceivedChrome Full support YesEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
requestsSentChrome Full support YesEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
responsesReceivedChrome Full support YesEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
responsesSentChrome Full support YesEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support YesFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
retransmissionsReceivedChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
retransmissionsSentChrome No support NoEdge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
stateChrome No support NoEdge ? Firefox Full support 29IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 29Opera Android ? Safari iOS ? Samsung Internet Android No support No
totalRoundTripTimeChrome Full support 71
Full support 71
Full support Yes
Alternate Name
Alternate Name Uses the non-standard name: totalRtt
Edge ? Firefox No support NoIE No support NoOpera ? Safari ? WebView Android No support NoChrome Android Full support 71
Full support 71
Full support Yes
Alternate Name
Alternate Name Uses the non-standard name: totalRtt
Firefox Android No support NoOpera Android ? Safari iOS ? Samsung Internet Android No support No
transportIdChrome No support NoEdge ? Firefox Full support 56
Full support 56
Full support 29
Alternate Name
Alternate Name Uses the non-standard name: componentId
IE No support NoOpera ? Safari ? WebView Android No support NoChrome Android No support NoFirefox Android Full support 56
Full support 56
Full support 29
Alternate Name
Alternate Name Uses the non-standard name: componentId
Opera Android ? Safari iOS ? Samsung Internet Android No support No
writable
Non-standard
Chrome Full support Yes
Notes
Full support Yes
Notes
Notes Chrome does not currently use the specification's algorithm to determine the value of writable; it may not match the behavior of other browsers.
Edge ? Firefox Full support 56IE No support NoOpera ? Safari ? WebView Android Full support YesChrome Android Full support Yes
Notes
Full support Yes
Notes
Notes Chrome does not currently use the specification's algorithm to determine the value of writable; it may not match the behavior of other browsers.
Firefox Android Full support 56Opera Android ? Safari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Non-standard. Expect poor cross-browser support.
Non-standard. Expect poor cross-browser support.
See implementation notes.
See implementation notes.
Uses a non-standard name.
Uses a non-standard name.