RTCStatsReport: values() 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 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 iterieren.

Die Werte sind Statistik-Wörterbuchobjekte.

Die Methode entspricht ansonsten Map.prototype.values().

Syntax

js
values()

Rückgabewert

Beispiele

Dieses Beispiel zeigt, wie man durch ein RTCStatsReport mit dem von values() zurückgegebenen Iterator iteriert.

Angenommen, es gibt eine Variable myPeerConnection, die eine Instanz von RTCPeerConnection ist, ruft der Code getStats() mit await auf, um auf den Statistikbericht zu warten. Anschließend wird eine for...of Schleife zusammen mit dem von values() zurückgegebenen Iterator verwendet, um durch die Wörterbuchobjekte im Bericht zu iterieren. Die Eigenschaften von Statistikobjekten mit dem type outbound-rtp werden in die Konsole protokolliert (andere Objekte werden verworfen).

js
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]}`);
  });
}

Spezifikationen

No specification found

No specification data found for api.RTCStatsReport.values.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

Siehe auch