WebTransport API
The sendGroup property of the WebTransportDatagramsWritable interface represents the WebTransportSendGroup that this WebTransportDatagramsWritable is grouped under for the purposes of WebTransportDatagramsWritable.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 datagrams written to the stream relative to other streams and datagrams that are part of the same group:
const sendGroup = transport.createSendGroup();
const writable = transport.datagrams.createWritable({
sendGroup,
sendOrder: 1,
});
console.log(writable.sendGroup === sendGroup); // true
const writer = writable.getWriter();
const data = new Uint8Array([65, 66, 67]);
await writer.ready;
writer.write(data).catch(() => {});
Specifications
Browser compatibility
See also
- Streams API
- Using WebTransport
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
