RTCRtpReceiver.getStats()
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.
Syntax
var promise = RTCRtpReceiver.getStats();
Return value
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.
Example
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(function(stats) {
document.getElementById("lostpackets").innerText =
stats.packetsLost;
});
Specifications
| Specification |
|---|
| WebRTC 1.0: Real-Time Communication Between Browsers # widl-RTCRtpReceiver-getStats-Promise-RTCStatsReport |
Browser compatibility
BCD tables only load in the browser