RTCDataChannelStats

Словарь RTCDataChannelStats API WebRTC предоставляет статистику, связанную с одним объектом RTCDataChannel на подключении.

Отчёт можно получить, итерируя RTCStatsReport, возвращённый RTCPeerConnection.getStats(), пока не будет найдена запись с type типа data-channel.

Статистику каналов данных можно соотнести с конкретным каналом, сравнив свойство dataChannelIdentifier с соответствующим RTCDataChannel.id.

bytesSent Необязательно

Положительное целое число, указывающее общее количество байтов полезной нагрузки, отправленных по связанному RTCDataChannel.

bytesReceived Необязательно

Положительное целое число, указывающее общее количество байтов полезной нагрузки, полученных по связанному RTCDataChannel.

dataChannelIdentifier Необязательно

Положительное целое число, содержащее id связанного RTCDataChannel.

label Необязательно

Строка, содержащая label связанного RTCDataChannel.

messagesReceived Необязательно

Положительное целое число, указывающее общее количество событий message, сгенерированных для полученных сообщений по связанному RTCDataChannel.

messagesSent Необязательно

Положительное целое число, указывающее общее количество событий message, сгенерированных для отправленных сообщений по каналу.

protocol Необязательно

Строка, содержащая protocol связанного RTCDataChannel.

state

readyState связанного RTCDataChannel.

Следующие свойства являются общими для всех объектов статистики WebRTC (см. RTCStatsReport для получения дополнительной информации).

id

Строка, уникально идентифицирующая объект, который отслеживается для получения этого набора статистики.

timestamp

Объект DOMHighResTimeStamp, указывающий время, в которое была взята выборка для этого объекта статистики.

type

Строка со значением "data-channel", указывающая тип статистики, содержащейся в объекте.

Учитывая переменную myPeerConnection, которая является экземпляром RTCPeerConnection, код ниже использует await для ожидания отчета о статистике, а затем итерирует его с помощью RTCStatsReport.forEach(). Затем он фильтрует словари только для тех отчётов, у которых тип data-channel, и выводит результат.

const stats = await myPeerConnection.getStats();

stats.forEach((report) => {
  if (report.type === "data-channel") {
    // Log the channel information
    console.log(report);
  }
});