WebTransportSendGroup
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.
Das WebTransportSendGroup Interface der WebTransport API repräsentiert eine Gruppe von Streams und Datagrammen, innerhalb derer die relative Sendepriorität durch den sendOrder Wert jedes Mitglieds bestimmt wird.
WebTransportSendGroup ist ein übertragbares Objekt.
Instanzmethoden
getStats()-
Gibt ein
Promisezurück, das mit einem Objekt aufgelöst wird, das Statistiken enthält, die über alle aktuellenWebTransportSendStream- undWebTransportDatagramsWritable-Objekte, die derzeit mit dieser Gruppe assoziiert sind, aggregiert sind.
Beschreibung
Anders als bei WritableStream-Instanzen, bei denen die Priorität, mit der Bytes auf verschiedenen Streams gesendet werden, von der Implementierung abhängt, ermöglicht ein WebTransportDatagramsWritable oder WebTransportSendStream, die Priorität einzustellen, mit der Bytes relativ zu anderen Instanzen in derselben sendGroup gesendet werden.
Eine Sendegruppe wird mit der Methode createSendGroup() erstellt und die relative Priorität wird durch die sendOrder-Eigenschaft von WebTransportDatagramsWritable oder WebTransportSendStream-Instanzen definiert.
Verschiedene Gruppen sollen für die Zwecke der Bandbreitenzuweisung als gleichwertig behandelt werden, obwohl die genaue Art und Weise, wie die Bandbreite zwischen Gruppen aufgeteilt wird, von der Implementierung abhängt.
Ein WebTransportSendGroup wird mithilfe der createSendGroup()-Methode des WebTransport-Interfaces erstellt.
Sie können es dann mit einem WebTransportDatagramsWritable oder WebTransportSendStream assoziieren, indem Sie:
- Es als
sendGroup-Option übergeben, wenn das Objekt erstellt wird — sieheWebTransport.createUnidirectionalStream(),WebTransport.createBidirectionalStream()undWebTransportDatagramDuplexStream.createWritable(). - Die
sendGroup-Eigenschaft des Objekts anschließend setzen, zum Beispiel mitWebTransportDatagramsWritable.sendGroup.
Beispiele
Grundlegende Verwendung
Im folgenden Beispiel wird eine Sendegruppe erstellt, dann assoziiert sie einen unidirektionalen Stream und den ausgehenden Datagramm-Stream der Verbindung mit ihr und gibt jedem einen sendOrder.
Bytes im Datagramm-Stream werden gegenüber allen Bytes im unidirektionalen Stream priorisiert, da sie beide in derselben sendGroup sind und der Datagramm-Stream eine höhere sendOrder hat.
const sendGroup = transport.createSendGroup();
const stream = await transport.createUnidirectionalStream({
sendGroup,
sendOrder: 1,
});
const datagrams = transport.datagrams.createWritable({
sendGroup,
sendOrder: 2,
});
Spezifikationen
| Spezifikation |
|---|
| WebTransport # webtransportsendgroup |