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 des RTCStatsReport-Interfaces gibt ein neues Iterator-Objekt zurück, das verwendet werden kann, um durch die Schlüssel/Wert-Paare für jedes Element im RTCStatsReport-Objekt in der Einfüge-Reihenfolge zu iterieren.
Die Schlüssel sind eindeutige id-Werte für überwachte Statistikobjekte, aus denen die Statistiken abgeleitet werden, und die zugehörigen Werte sind Statistik-Dictionary-Objekte.
Die Methode entspricht ansonsten Map.prototype.entries().
Syntax
entries()
Parameter
Keine.
Rückgabewert
Ein neues iterierbares Iterator-Objekt.
Beispiele
Dieses Beispiel zeigt, wie man durch ein RTCStatsReport mithilfe des von entries() zurückgegebenen Iterators iteriert.
Gegeben ist eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist. Der Code ruft getStats() mit await auf, um auf den Statistikbericht zu warten.
Dann wird eine for...of-Schleife verwendet, um mit dem von entries() zurückgegebenen Iterator durch die Einträge zu iterieren.
Die Eigenschaften der Statistikobjekte mit dem type outbound-rtp werden in die Konsole protokolliert (andere Objekte werden verworfen).
const stats = await myPeerConnection.getStats();
for (const stat of stats.entries()) {
if (stat.type !== "outbound-rtp") continue;
Object.keys(stat).forEach((statName) => {
console.log(`${statName}: ${report[statName]}`);
});
}
Spezifikationen
| Spezifikation |
|---|
| WebRTC: Real-Time Communication in Browsers # dom-rtcstatsreport |