WebTransportSendGroup: getStats() method
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
The getStats() method of the WebTransportSendGroup interface returns a Promise that resolves to an object that contains statistics aggregated across all of the WebTransportSendStream and WebTransportDatagramsWritable objects that are currently associated with this group.
That is, every stream and datagram writable whose sendGroup is set to this WebTransportSendGroup.
Syntax
getStats()
Parameters
None.
Return value
A Promise that resolves to an object containing aggregated statistics for the group's members.
The returned object has the following properties:
bytesAcknowledged-
A positive integer indicating the number of bytes written to the group's members that have been sent and acknowledged as received by the server, using QUIC's ACK mechanism. Only sequential bytes up to, but not including, the first non-acknowledged byte of each member, are counted. This number can only increase and is always less than or equal to
bytesSent. bytesSent-
A positive integer indicating the number of bytes written to the group's members that have been sent at least once (but not necessarily acknowledged). This number can only increase, and is always less than or equal to
bytesWritten. Note that this count does not include bytes sent as network overhead (such as packet headers). bytesWritten-
A positive integer indicating the number of bytes successfully written to the group's members. This number can only increase.
Examples
Basic usage
The code snippet below uses await to wait on the Promise returned by getStats(), then logs the number of bytes that have been sent across the group's members but not yet acknowledged:
const stats = await sendGroup.getStats();
const bytesNotAcknowledged = stats.bytesSent - stats.bytesAcknowledged;
console.log(`Bytes sent but not yet acknowledged: ${bytesNotAcknowledged}`);
Specifications
| Specification |
|---|
| WebTransport # dom-webtransportsendgroup-getstats |