大网数据广告活动
Web 标准与前端开发

RTCStatsReport: keys() method

· 52CE 我爱测

The **`keys()`** method of the RTCStatsReport interface returns a new _iterator_ object that can be used to iterate through the keys for each element in the `RTCStatsReport` object, in insertion order.

WebRTC

The keys() method of the RTCStatsReport interface returns a new iterator object that can be used to iterate through the keys for each element in the RTCStatsReport object, in insertion order.

The keys in the RTCStatsReport are unique string id values, which represent the monitored statistics objects from which the statistics are derived.

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

Syntax

keys()

Parameters

None.

Return value

A new iterable iterator object.

Examples

This example shows how to iterate through a RTCStatsReport using the iterator returned by keys().

Given a variable myPeerConnection, which is an instance of RTCPeerConnection, the code calls getStats() with await to wait for the statistics report. It then uses a for...of loop, with the iterator returned by keys(), to iterate through the IDs. Each ID is used to get the corresponding statistics dictionary. The properties of statistics objects with the type of outbound-rtp are logged to the console (other objects are discarded).

const stats = await myPeerConnection.getStats();

for (const id of stats.keys()) {
  // Get dictionary associated with key (id)
  const stat = stats.get(id);
  if (stat.type !== "outbound-rtp") continue;
  Object.keys(stat).forEach((statName) => {
    console.log(`${statName}: ${stat[statName]}`);
  });
}

Note that this examples is somewhat contrived. You could more easily iterate with RTCStatsReport.entries() or RTCStatsReport.values() and not have to map the ID to a value. You can even iterate the RTCStatsReport itself, as it has the [Symbol.iterator]() method!

Specifications

Browser compatibility

See also

  • Map.prototype.keys()
  • RTCStatsReport.values()
  • RTCStatsReport.entries()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。