WebTransportSendGroup

Instanzmethoden

getStats()

Gibt ein Promise zurück, das mit einem Objekt aufgelöst wird, das Statistiken enthält, die über alle derzeit mit dieser Gruppe verbundenen WebTransportSendStream- und WebTransportDatagramsWritable-Objekte aggregiert sind.

Beschreibung

Im Gegensatz zu 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, dass Sie die Priorität festlegen können, mit der Bytes auf jeder Instanz relativ zu anderen im gleichen sendGroup gesendet werden. Eine Sendgruppe wird mit der createSendGroup()-Methode erstellt, und die relative Priorität wird durch die sendOrder-Eigenschaft der WebTransportDatagramsWritable- oder WebTransportSendStream-Instanzen definiert. Unterschiedliche Gruppen sollten im Hinblick auf die Bandbreitenzuweisung gleich behandelt werden — obwohl die genaue Art, wie die Bandbreite zwischen Gruppen aufgeteilt wird, von der Implementierung abhängt.

Eine WebTransportSendGroup wird mit der createSendGroup()-Methode der WebTransport-Schnittstelle erstellt. Sie können sie dann mit einem WebTransportDatagramsWritable oder WebTransportSendStream verbinden, indem Sie:

• sie als sendGroup-Option beim Erstellen des Objekts übergeben — siehe WebTransport.createUnidirectionalStream(), WebTransport.createBidirectionalStream() und WebTransportDatagramDuplexStream.createWritable().
• die sendGroup-Eigenschaft des Objekts später setzen — siehe WebTransportSendStream.sendGroup und WebTransportDatagramsWritable.sendGroup.

Beispiele

Grundlegende Verwendung

Das untenstehende Beispiel erstellt eine Sendgruppe, dann wird ein unidirektionaler Stream und der ausgehende Datagramm-Stream der Verbindung mit der Gruppe verbunden, wobei jedem ein sendOrder zugewiesen wird. Bytes auf dem Datagramm-Stream werden vor allen Bytes auf dem unidirektionalen Stream priorisiert, da sie beide in derselben sendGroup 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

Browser-Kompatibilität

Siehe auch

• Verwendung von WebTransport
• Streams API