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

RTCIceCandidatePairStats: selected property

· 52CE 我爱测

The **`selected`** property of the RTCIceCandidatePairStats dictionary indicates whether or not the candidate pair described by the object is the one currently being used to communicate with the remote peer.

WebRTC

The selected property of the RTCIceCandidatePairStats dictionary indicates whether or not the candidate pair described by the object is the one currently being used to communicate with the remote peer.

This property is non-standard and is only supported by Firefox. The standard way to determine the selected candidate pair is to look at the selectedCandidatePairId property of the stats object of type transport.

Value

true if the candidate pair described by this object is the one currently in use, and false otherwise.

Examples

The function shown in this example identifies the currently-selected candidate pair from a statistics report by first iterating over each report, looking for a transport report. When one is found, that transport's selectedCandidatePairId is used to get the RTCIceCandidatePair describing the connection.

If that fails, then the second part iterates over the reports, looking for a candidate-pair record whose Firefox-specific selected property is true. This candidate pair is then returned as the currently-selected one.

function getCurrentCandidatePair(statsResults) {
  statsResults.forEach((report) => {
    if (report.type === "transport") {
      currentPair = statsResults.get(report.selectedCandidatePairId);
    }
  });

  if (!currentPair) {
    statsResults.forEach((report) => {
      if (report.type === "candidate-pair" && report.selected) {
        currentPair = report;
      }
    });
  }

  return currentPair;
}

Specifications

Not part of any specification. This property is unique to Firefox.

Browser compatibility

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

资料来源与适用范围

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

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

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