RTCStatsReport: get() method

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.

The get() method of the RTCStatsReport interface returns a specified element from an RTCStatsReport.

Elements in the RTCStatsReport are identified by unique id values, which represent the monitored statistics objects from which the statistics are derived. The element returned will be an instance of one of the statistics dictionary objects, and it will contain statistics for the object with the given id. The fetched value is a reference to the statistics dictionary, and any change made to that object will effectively modify it inside the RTCStatsReport object.

The method is otherwise the same as Map.prototype.get().

Syntax

js
get(id)

Parameters

id

A string indicating the ID of the element to return from the RTCStatsReport object. IDs are unique strings that identify the monitored object from which the corresponding statistics are derived.

Return value

The element associated with the specified id key, or undefined if the key can't be found in the Map object.

Specifications

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

Browser compatibility

desktop mobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
get
Chrome – Full support
Chrome 58 (Release date: 2017-04-19)
footnote Full support
Edge – Full support
Edge 79 (Release date: 2020-01-15)
footnote Full support
Firefox – Full support
Firefox 27 (Release date: 2014-02-04)
footnote Full support
Opera – Full support
Opera 45 (Release date: 2017-05-10)
footnote Full support
Safari – Full support
Safari 11 (Release date: 2017-09-19)
footnote Full support
Chrome Android – Full support
Chrome Android 58 (Release date: 2017-04-25)
footnote Full support
Firefox for Android – Full support
Firefox for Android 27 (Release date: 2014-02-04)
footnote Full support
Opera Android – Full support
Opera Android 43 (Release date: 2017-09-27)
footnote Full support
Safari on iOS – Full support
Safari on iOS 11 (Release date: 2017-09-19)
footnote Full support
Samsung Internet – Full support
Samsung Internet 7 (Release date: 2018-03-16)
footnote Full support
WebView Android – Full support
WebView Android 58 (Release date: 2017-04-25)
footnote Full support
WebView on iOS – Full support
WebView on iOS 11 (Release date: 2017-09-19)
footnote Full support

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

See also