WebTransportSendStream: 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 WebTransportSendStream-Schnittstelle repräsentiert die WebTransportSendGroup, unter der dieser Stream für die Zwecke der Priorisierung der sendOrder gruppiert ist.
Innerhalb einer Gruppe werden Bytes, die zum Senden auf Streams und Datagrams mit einer höheren sendOrder-Priorität vorgesehen sind, vor allen Bytes von niedrigeren Prioritäten gesendet.
Verschiedene Gruppen sollen für die Zwecke der Bandbreitenzuweisung als gleichwertig betrachtet werden – die genaue Art und Weise, wie die Bandbreite zwischen den Gruppen aufgeteilt wird, ist jedoch implementierungsabhängig.
Wert
Ein WebTransportSendGroup-Objekt oder null, um die Standard-Sendegruppe anzugeben.
Der Standardwert ist null.
Ausnahmen
InvalidStateErrorDOMException-
Wird ausgelöst, wenn auf eine
WebTransportSendGroupgesetzt wird, die mit einem anderenWebTransport-Objekt als diesem Stream verbunden ist.
Beispiele
Grundlegende Verwendung
Das folgende Beispiel erstellt eine Sendegruppe mithilfe der WebTransport.createSendGroup()-Methode und verwendet sie dann mit einem sendOrder-Wert, um den Stream relativ zu anderen Streams und Datagrams, die Teil derselben Gruppe sind, zu priorisieren:
const sendGroup = transport.createSendGroup();
const stream = await transport.createUnidirectionalStream({
sendGroup,
sendOrder: 1,
});
console.log(stream.sendGroup === sendGroup); // true
Spezifikationen
| Spezifikation |
|---|
| WebTransport # dom-webtransportsendstream-sendgroup |