WebTransportDatagramsWritable: sendOrder-Eigenschaft
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.
Die sendOrder-Eigenschaft der WebTransportDatagramsWritable-Schnittstelle repräsentiert die Priorität von Datagrammen dieses Streams relativ zu anderen Streams und Datagrammen in derselben sendGroup, als Ganzzahl.
Innerhalb einer sendGroup werden Bytes, die zum Senden auf Streams und Datagrammen mit einer höheren sendOrder-Priorität eingereiht sind, vor allen Bytes mit niedrigerer Priorität gesendet.
Verschiedene Gruppen werden gleich behandelt, was die Zuweisung von Bandbreite betrifft — obwohl die genaue Art und Weise, wie Bandbreite zwischen Gruppen aufgeteilt wird, von der Implementierung definiert ist.
Wert
Eine Ganzzahl, die die relative Priorität der Datagramme dieses Streams beim Senden von Bytes angibt.
Der Standardwert ist 0.
Beispiele
Grundlegende Verwendung
Das folgende Beispiel zeigt, wie Sie die anfängliche sendOrder-Priorität festlegen können, wenn createWritable() aufgerufen wird, um den schreibbaren Stream zu erstellen, den Wert vom Stream zurücklesen und ihn dann ändern:
const writable = transport.datagrams.createWritable({
sendOrder: 1, // Set initial send order
});
console.log(`Send order: ${writable.sendOrder}`); // Send order: 1
const writer = writable.getWriter();
const data = new Uint8Array([65, 66, 67]);
await writer.ready;
writer.write(data).catch(() => {});
// Increase the priority of this stream's datagrams
writable.sendOrder = 2;
console.log(`Send order: ${writable.sendOrder}`); // Send order: 2
Spezifikationen
| Spezifikation |
|---|
| WebTransport # dom-webtransportdatagramswritable-sendorder |