RTCStatsReport: Methode values()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Die Methode values() der Schnittstelle RTCStatsReport gibt ein neues Iterator-Objekt zurück. Damit können Sie in der Reihenfolge, in der die Einträge hinzugefügt wurden, über die Werte jedes Eintrags im RTCStatsReport-Objekt iterieren.
Die Werte sind Statistik-Dictionary-Objekte.
Ansonsten entspricht die Methode Map.prototype.values().
Syntax
values()
Parameter
Keine.
Rückgabewert
Ein neues iterierbares Iterator-Objekt.
Beispiele
Dieses Beispiel zeigt, wie Sie mit dem von values() zurückgegebenen Iterator über einen RTCStatsReport iterieren.
Für die Variable myPeerConnection, eine Instanz von RTCPeerConnection, ruft der Code getStats() auf und wartet mit await auf den Statistikbericht.
Anschließend verwendet er eine for...of-Schleife mit dem von values() zurückgegebenen Iterator, um über die Dictionary-Objekte im Bericht zu iterieren.
Die Eigenschaften von Statistikobjekten mit dem type outbound-rtp werden in der Konsole ausgegeben (andere Objekte werden verworfen).
const stats = await myPeerConnection.getStats();
for (const stat of stats.values()) {
if (stat.type !== "outbound-rtp") continue;
Object.keys(stat).forEach((statName) => {
console.log(`${statName}: ${stat[statName]}`);
});
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # rtcstatsreport-object |
| Web IDL # dfn-maplike |