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.
Das WebTransportDatagramsWritable-Interface der WebTransport-API ist ein spezialisiertes WritableStream, das verwendet werden kann, um ausgehende Datagramme über eine WebTransport-Verbindung zu schreiben.
WebTransportDatagramsWritable ist ein übertragbares Objekt.
Instanz-Eigenschaften
Erbt auch Eigenschaften von seinem Eltern-Interface, WritableStream.
WebTransportDatagramsWritable.sendGroup-
Ruft eine
WebTransportSendGroupab oder setzt diese, unter der die Datagramme des Streams für diesendOrder-Priorisierung gruppiert werden. WebTransportDatagramsWritable.sendOrder-
Ruft eine Ganzzahl ab oder setzt diese, die die Priorität dieses Streams relativ zu anderen Streams und Datagrammen in derselben
sendGroupangibt.
Instanz-Methoden
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 in Streams und Datagrammen mit höherer Priorität eingereiht sind, vor den Bytes aus solchen mit niedrigerer Priorität gesendet.
Verschiedene Gruppen sollen bei der Bandbreitenzuteilung als gleich betrachtet werden — obwohl die genaue Art und Weise, wie Bandbreite zwischen Gruppen aufgeteilt wird, implementierungsdefiniert ist.
Objekte dieses Typs werden nicht direkt konstruiert.
Stattdessen wird eine Instanz von der createWritable()-Methode von WebTransportDatagramDuplexStream zurückgegeben, die über die WebTransport.datagrams-Eigenschaft zugänglich ist.
Die Übertragung ist unzuverlässig, was bedeutet, dass, obwohl Sie die Prioritätsreihenfolge definieren können, keine Garantie besteht, dass jedes Datagramm gesendet wird oder dass sie in einer bestimmten Reihenfolge ankommen.
Beispiele
Siehe createWritable() für ein Beispiel, das zeigt, wie ein WebTransportDatagramsWritable erstellt wird und wie es verwendet wird, um ausgehende Datagramme zu schreiben.
Spezifikationen
| Spezifikation |
|---|
| WebTransport> # datagram-writable> |