WebTransportDatagramsWritable
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 WebTransportDatagramsWritable Interface der WebTransport-API ist ein spezialisiertes WritableStream, das verwendet werden kann, um ausgehende Datagramme zu einer WebTransport-Verbindung zu schreiben.
WebTransportDatagramsWritable ist ein übertragbares Objekt.
Instanzeigenschaften
Erbt auch Eigenschaften von seinem Eltern-Interface, WritableStream.
WebTransportDatagramsWritable.sendGroup-
Ruft eine
WebTransportSendGroupab oder legt diese fest, unter der die Datagramme des Streams für die Priorisierung dessendOrdergruppiert werden. WebTransportDatagramsWritable.sendOrder-
Ruft eine Ganzzahl ab oder legt diese fest, die die Priorität dieses Streams relativ zu anderen Streams und Datagrammen in derselben
sendGroupangibt.
Instanzmethoden
Erbt Methoden von seinem Eltern-Interface, WritableStream.
Beschreibung
Zusätzlich zur Funktionalität eines standardmäßigen WritableStream bietet das WebTransportDatagramsWritable-Interface die sendGroup-Eigenschaft, die die Gruppe von Streams und Datagrammen angibt, zu der dieser Stream gehört, und die sendOrder-Eigenschaft, die die relative Priorität dieses Streams innerhalb dieser Gruppe angibt.
Innerhalb einer Gruppe werden Bytes, die bei Streams und Datagrammen mit höherer Priorität eingereiht sind, vor allen Bytes von niedrigeren Prioritäten gesendet.
Verschiedene Gruppen sollen für die Zwecke der Bandbreitenverteilung als gleichwertig behandelt werden — obgleich die genaue Art und Weise, wie die Bandbreite zwischen Gruppen aufgeteilt wird, implementierungsdefiniert ist.
Objekte dieses Typs werden nicht direkt konstruiert.
Stattdessen wird eine Instanz durch die createWritable()-Methode von WebTransportDatagramDuplexStream zurückgegeben, auf die über die WebTransport.datagrams-Eigenschaft zugegriffen werden kann.
Die Übertragung ist unzuverlässig, was bedeutet, dass, obwohl Sie die Prioritätenreihenfolge festlegen können, es keine Garantie gibt, dass jedes Datagramm gesendet oder in einem bestimmten Auftrag angekommen wird.
Beispiele
Sehen Sie sich createWritable() für ein Beispiel an, das zeigt, wie man ein WebTransportDatagramsWritable erstellt und es verwendet, um ausgehende Datagramme zu schreiben.
Spezifikationen
| Spezifikation |
|---|
| WebTransport # datagram-writable |