web api instance method
RTCStatsReport: forEach() method
The forEach() method of the RTCStatsReport interface executes a provided function once for each key/value pair in the RTCStatsReport object, in insertion order.
The keys are unique id values for the monitored statistics objects from which the statistics are derived, and the associated values are statistics dictionary objects.
The method is otherwise the same as forEach().
Syntax
forEach(callbackFn)
forEach(callbackFn, thisArg)
Parameters
-
callbackFn- : A function to execute for each entry in the report.
The function is called with the following arguments:
report- : Statistics report for each iteration. This can be any of the statistics dictionary types.
id- : A unique string identifying the monitored object from which the statistics are derived.
map- : The report being iterated.
- : A function to execute for each entry in the report.
The function is called with the following arguments:
-
thisArgOptional- : A value to use as
thiswhen executingcallbackFn.
- : A value to use as
Return value
Examples
Given a variable myPeerConnection, which is an instance of RTCPeerConnection, the code calls getStats() with await to wait for the statistics report.
It then iterates the report using RTCStatsReport.forEach(), and filters the dictionaries for just those reports that have the type of inbound-rtp and kind of video.
For matching dictionaries it logs the framesPerSecond property of the inbound video.
const stats = await myPeerConnection.getStats();
stats.forEach((report) => {
if (report.type === "inbound-rtp" && report.kind === "video") {
// Log the frame rate
console.log(report.framesPerSecond);
}
});