WebTransportSendStream: sendGroup property
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 sendGroup property of the WebTransportSendStream interface represents the WebTransportSendGroup that this stream is grouped under for the purposes of sendOrder prioritization.
Within a group, bytes queued for sending on streams and datagrams with a higher sendOrder are sent before any bytes from lower-priority ones.
Different groups are expected to be treated as equals for the purposes of bandwidth allocation — though the precise way bandwidth is divided between groups is implementation-defined.
Value
A WebTransportSendGroup object, or null to specify the default send group.
The default value is null.
Exceptions
InvalidStateErrorDOMException-
Thrown if set to a
WebTransportSendGroupthat is associated with a differentWebTransportobject than this stream.
Examples
Basic usage
The example below creates a send group using the WebTransport.createSendGroup() method, and then uses it with a sendOrder value, to prioritize the stream relative to other streams and datagrams that are part of the same group:
const sendGroup = transport.createSendGroup();
const stream = await transport.createUnidirectionalStream({
sendGroup,
sendOrder: 1,
});
console.log(stream.sendGroup === sendGroup); // true
Specifications
| Specification |
|---|
| WebTransport # dom-webtransportsendstream-sendgroup |