RTCStatsReport: entries()-Methode
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 entries()-Methode der RTCStatsReport-Schnittstelle gibt ein neues Iterator-Objekt zurück. Damit können Sie die Schlüssel-Wert-Paare aller Elemente im RTCStatsReport-Objekt in der Reihenfolge durchlaufen, in der sie eingefügt wurden.
Die Schlüssel sind eindeutige id-Werte überwachter Statistikobjekte, aus denen die Statistiken abgeleitet werden. Die zugehörigen Werte sind Statistik-Dictionary-Objekte.
Ansonsten entspricht die Methode Map.prototype.entries().
Syntax
entries()
Parameter
Keine.
Rückgabewert
Ein neues iterierbares Iterator-Objekt.
Beispiele
Dieses Beispiel zeigt, wie Sie einen RTCStatsReport mit dem von entries() zurückgegebenen Iterator durchlaufen.
Der Code setzt voraus, dass die Variable myPeerConnection eine Instanz von RTCPeerConnection ist. Er ruft getStats() auf und wartet mit await auf den Statistikbericht.
Anschließend durchläuft er die Einträge mit einer for...of-Schleife und dem von entries() zurückgegebenen Iterator.
Die Eigenschaften der Statistikobjekte mit dem type outbound-rtp werden in der Konsole ausgegeben (andere Objekte werden verworfen).
const stats = await myPeerConnection.getStats();
for (const [id, stat] of stats.entries()) {
if (stat.type !== "outbound-rtp") continue;
Object.keys(stat).forEach((statName) => {
console.log(`${statName}: ${stat[statName]}`);
});
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcstatsreport |