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 des RTCStatsReport-Interfaces gibt ein neues Iterator-Objekt zurück, das verwendet werden kann, um die Werte für jedes Element im RTCStatsReport-Objekt in der Reihenfolge der Einfügung zu durchlaufen.

Die Werte sind Statistik-Dictionary-Objekte.

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

Syntax

js
values()

Rückgabewert

Ein neues iterierbares Iterator-Objekt.

Beispiele

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

Angenommen, eine Variable myPeerConnection ist eine Instanz von RTCPeerConnection, ruft der Code getStats() mit await auf, um auf den Statistikbericht zu warten. Anschließend wird eine for...of-Schleife verwendet, um mit dem von values() zurückgegebenen Iterator durch die Dictionary-Objekte im Bericht zu iterieren. Die Eigenschaften der Statistikobjekte mit dem type outbound-rtp werden in der 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

BCD tables only load in the browser

Siehe auch