WebTransport API
The sendGroup property of the WebTransportSendStream interface represents the WebTransportSendGroup that this stream is grouped under for the purposes of WebTransportSendStream.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.
- : Thrown if set to a
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
Browser compatibility
See also
- WebTransportSendGroup
- WebTransportSendStream.sendOrder
- Streams API
- Using WebTransport
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
