RTCStatsReport: values() 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 values() Methode der RTCStatsReport Schnittstelle gibt ein neues Iterator Objekt zurück, das verwendet werden kann, um die Werte für jedes Element im RTCStatsReport Objekt in Einfügereihenfolge zu durchlaufen.
Die Werte sind Statistiken-Dictionary-Objekte.
Die Methode ist ansonsten identisch mit Map.prototype.values().
Syntax
values()
Parameter
Keine.
Rückgabewert
Ein neues iterierbares Iterator-Objekt.
Beispiele
Dieses Beispiel zeigt, wie man durch ein RTCStatsReport mit dem Iterator, der von values() zurückgegeben wird, iteriert.
Angenommen, eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist, wird verwendet, ruft der Code getStats() mit await auf, um auf den Statistikbericht zu warten.
Anschließend wird eine for...of Schleife mit dem Iterator, den values() zurückgibt, verwendet, um die Dictionary-Objekte im Bericht zu durchlaufen.
Die Eigenschaften von Statistikobjekten mit dem type outbound-rtp werden in die Konsole protokolliert (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}: ${report[statName]}`);
});
}