RTCStatsReport: values() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起，所有主流瀏覽器均已支援。

RTCStatsReport 介面的 values() 方法會返回一個新的迭代器物件，該物件可用於按插入順序遍歷 RTCStatsReport 物件中每個元素的對應值。

該方法在其他方面與 Map.prototype.values() 相同。

示例

此示例展示瞭如何使用 values() 返回的迭代器來遍歷 RTCStatsReport。

給定一個變數 myPeerConnection（它是 RTCPeerConnection 的一個例項），程式碼使用 await 呼叫 getStats() 來等待統計資訊報告。然後，它使用 for...of 迴圈（結合 values() 返回的迭代器）來遍歷報告中的字典物件。控制檯會記錄 type 為 outbound-rtp 的統計資訊物件的屬性（其他物件會被丟棄）。

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]}`);
  });
}