WebTransport: createSendGroup() Methode

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.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die createSendGroup() Methode der WebTransport Schnittstelle erstellt und gibt eine WebTransportSendGroup zurück.

Syntax

createSendGroup()

Ausnahmen

InvalidStateError DOMException: Wird ausgelöst, wenn der Zustand des Transports "closed" oder "failed" ist.

Beschreibung

Die createSendGroup() Methode erstellt eine neue WebTransportSendGroup, die mit dem WebTransport Objekt, auf dem sie aufgerufen wird, verknüpft ist.

Das WebTransportSendGroup Objekt wird verwendet, um Streams und/oder Datagramme, die auf demselben WebTransport erstellt wurden, zu gruppieren und deren relative Priorität für das Senden von wartenden Bytes zu steuern. Innerhalb derselben Gruppe werden Bytes auf Streams und Datagrammen mit höherer Priorität vor denen aus Streams und Datagrammen mit niedrigerer Priorität gesendet.

Die zurückgegebene WebTransportSendGroup ist anfangs nicht mit Streams oder Datagrammen verknüpft. Sie können es auf verschiedene Arten mit einem WebTransportDatagramsWritable oder WebTransportSendStream Objekt verknüpfen:

Indem Sie es als sendGroup Option übergeben, wenn das Objekt erstellt wird — siehe WebTransport.createUnidirectionalStream(), WebTransport.createBidirectionalStream() und WebTransportDatagramDuplexStream.createWritable().
Indem Sie die sendGroup Eigenschaft des Objekts danach setzen — siehe WebTransportSendStream.sendGroup und WebTransportDatagramsWritable.sendGroup.

Verschiedene Gruppen sollten bei der Bandbreitenzuweisung als gleichwertig behandelt werden — obwohl die genaue Methode der Bandbreitenteilung zwischen Gruppen durch die Implementierung definiert wird.

Beispiele

Grundlegende Nutzung

Dieses Beispiel erstellt eine Sendgruppe und verknüpft dann einen unidirektionalen Stream und den ausgehenden Datagramm-Stream der Verbindung mit ihr. Jeder erhält eine sendOrder, die ihre relative Priorität definiert.

const sendGroup = transport.createSendGroup();

const stream = await transport.createUnidirectionalStream({
  sendGroup,
  sendOrder: 1,
});

// Higher sendOrder: queued bytes on this stream are sent first
const datagrams = transport.datagrams.createWritable({
  sendGroup,
  sendOrder: 2,
});