RTCStatsReport: метод keys()

Метод keys() интерфейса RTCStatsReport возвращает новый объект итератора, который можно использовать для перебора ключей каждого элемента в объекте RTCStatsReport, в порядке вставки.

Ключи в объекте RTCStatsReport являются уникальными строковыми id значениями, представляющими отслеживаемые объекты статистики, из которых извлекаются статистические данные.

Метод аналогичен методу Map.prototype.keys().

Новый объект итератора.

В этом примере показано, как перебрать RTCStatsReport с помощью итератора, возвращаемого keys().

Предположим, у нас есть переменная myPeerConnection, которая является экземпляром RTCPeerConnection. Код вызывает getStats() с await, чтобы дождаться отчета о статистике. Затем, используя цикл for...of с итератором, возвращаемым keys(), перебирает идентификаторы. Каждый идентификатор используется для получения соответствующего словаря статистики. Свойства объектов статистики с type outbound-rtp выводятся в консоль (другие объекты игнорируются).

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}: ${report[statName]}`);
  });
}

Обратите внимание, что этот пример несколько искусственный. Вы могли бы проще перебрать данные с помощью entries() или values() и не нужно было бы сопоставлять идентификатор со значением. Вы даже можете перебрать сам RTCStatsReport, так как у него есть метод [Symbol.iterator]()!

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