The RTCRtpReceiver
method getStats()
asynchronously requests an RTCStatsReport
object which provides statistics about incoming traffic on the owning RTCPeerConnection
, returning a Promise
whose fulfillment handler will be called once the results are available.
A JavaScript Promise
which is fulfilled once the statistics are available. The promise's fulfillment handler receives as a parameter a RTCStatsReport
object containing the collected statistics.
The returned statistics include those from all streams which are coming in through the RTCRtpReceiver
, as well as any of their dependencies.
These might include, for example, statistics with types: inbound-rtp
, candidate-pair
, local-candidate
, remote-candidate
.
This simple example obtains the statistics for an RTCRtpReceiver
and updates an element's innerText
to display the number of packets lost.
receiver.getStats().then((stats) => {
document.getElementById("lostpackets").innerText = stats.packetsLost;
});