RTCStatsReport: entries() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die entries() Methode des RTCStatsReport Interfaces gibt ein neues Iterator-Objekt zurück, das verwendet werden kann, um die Schlüssel/Wert-Paare für jedes Element im RTCStatsReport Objekt in Einfügereihenfolge zu durchlaufen.

Die Schlüssel sind eindeutige id-Werte für überwachte Statistikobjekte, aus denen die Statistiken abgeleitet werden, und die zugehörigen Werte sind Statistik-Wörterbuchobjekte.

Die Methode ist ansonsten identisch mit Map.prototype.entries().

Syntax

js
entries()

Parameter

Keine.

Rückgabewert

Ein neues iterierbares Iterator-Objekt.

Beispiele

Dieses Beispiel zeigt, wie man ein RTCStatsReport mithilfe des Iterators, der von entries() zurückgegeben wird, durchlaufen kann.

Angenommen, Sie haben eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist, dann ruft der Code getStats() mit await auf, um auf den Statistikbericht zu warten. Anschließend wird eine for...of Schleife mit dem Iterator verwendet, der von entries() zurückgegeben wird, um durch die Einträge zu iterieren. Die Eigenschaften von Statistikobjekten mit dem type von outbound-rtp werden in die Konsole protokolliert (andere Objekte werden verworfen).

js
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

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcstatsreport

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch