Поток отправки WebTransport: метод getStats()

Метод getStats() интерфейса WebTransportSendStream асинхронно возвращает объект, содержащий статистику для текущего потока.

Статистика включает общее количество байтов, записанных в поток, количество отправленных байтов (исключая избыточность пакетов), количество байтов, установленных как минимум один раз, и количество байтов, подтвержденных (до первого последовательно упорядоченного неподтвержденного байта). Таким образом, она показывает, насколько быстро приложение отправляет байты на сервер в этом конкретном потоке.

Нет.

А Promise, который разрешается в объект, содержащий статистику текущего потока. Возвращаемый объект имеет следующие свойства:

bytesAcknowledged

Положительное целое число, указывающее количество байтов, записанных в этот поток, которые были отправлены и подтверждены сервером как полученные с помощью механизма ACK QUIC. Учитываются только последовательные байты до, но не включая, первый неподтвержденный байт. Это число может только увеличиваться и всегда меньше или равно bytesSent. При подключении через HTTP/2 значение будет соответствовать bytesSent.

bytesSent

Положительное целое число, указывающее количество байтов, записанных в этот поток, которые были отправлены как минимум один раз (но не обязательно подтверждены). Это число может только увеличиваться и всегда меньше или равно bytesWritten. Обратите внимание, что это количество не включает байты, отправленные как сетевая избыточность (например, заголовки пакетов).

bytesWritten

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

В приведенном ниже фрагменте кода используется await для ожидания Promise, возвращаемого getStats(). После выполнения обещания результат количества отправленных, но не подтвержденных байтов регистрируется в консоли.

const stats = await stream.getStats();
const bytesNotReceived = stats.bytesWritten - stats.bytesAcknowledged;
console.log(`Bytes still successfully sent: ${bytesNotReceived}`);