WebTransportDatagramsWritable: sendGroup Eigenschaft
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die sendGroup-Eigenschaft der WebTransportDatagramsWritable-Schnittstelle repräsentiert die WebTransportSendGroup, zu der dieses WebTransportDatagramsWritable für die Zwecke der Priorisierung der sendOrder gruppiert ist.
Innerhalb einer Gruppe werden die für das Senden auf Streams und Datagrammen angezeigten Bytes mit einer höheren sendOrder vor allen Bytes aus solchen mit niedrigerer Priorität gesendet. Verschiedene Gruppen sollen gleich behandelt werden, um die Bandbreitenzuteilung zu gewährleisten – wobei die genaue Art und Weise, wie die Bandbreite zwischen den Gruppen aufgeteilt wird, von der Implementierung definiert wird.
Wert
Ein WebTransportSendGroup-Objekt oder null, um die Standard-Sendegruppe anzugeben.
Der Standardwert ist null.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn eine
WebTransportSendGroupgesetzt wird, die mit einem anderenWebTransport-Objekt als diesem Stream verbunden ist.
Beispiele
Grundlegende Verwendung
Das folgende Beispiel erstellt eine Sendegruppe mit der Methode WebTransport.createSendGroup() und verwendet diese dann mit einem sendOrder-Wert, um die Datagramme, die in den Stream geschrieben werden, im Vergleich zu anderen Streams und Datagrammen, die Teil derselben Gruppe sind, zu priorisieren:
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(() => {});
Spezifikationen
| Spezifikation |
|---|
| WebTransport # dom-webtransportdatagramswritable-sendgroup |