RTCStatsReport: get()-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 get()-Methode der RTCStatsReport-Schnittstelle gibt ein angegebenes Element aus einem RTCStatsReport zurück.

Elemente im RTCStatsReport werden durch eindeutige id-Werte identifiziert, die die überwachten Statistikobjekte repräsentieren, aus denen die Statistiken abgeleitet werden. Das zurückgegebene Element wird eine Instanz eines der Statistik-Wörterbuchobjekte sein und Statistiken für das Objekt mit der angegebenen id enthalten. Der abgerufene Wert ist eine Referenz auf das Statistik-Wörterbuch, und jede Änderung an diesem Objekt wird effektiv innerhalb des RTCStatsReport-Objekts modifiziert.

Die Methode verhält sich ansonsten genauso wie Map.prototype.get().

Syntax

js
get(id)

Parameter

id

Ein String, der die ID des Elements angibt, das vom RTCStatsReport-Objekt zurückgegeben werden soll. IDs sind eindeutige Zeichenfolgen, die das überwachte Objekt identifizieren, aus dem die entsprechenden Statistiken abgeleitet werden.

Rückgabewert

Das Element, das dem angegebenen id-Schlüssel zugeordnet ist, oder undefined, wenn der Schlüssel im Map-Objekt nicht gefunden werden kann.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch