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.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die sendOrder-Eigenschaft des WebTransportDatagramsWritable-Interfaces ruft eine Ganzzahl ab oder setzt sie, die die Priorität der Datagramme dieses Streams relativ zu anderen Streams und Datagrammen in derselben sendGroup angibt.
Innerhalb einer sendGroup werden die zum Senden in die Warteschlange gestellten Bytes auf Streams und Datagrammen mit einer höheren sendOrder vor jeglichen Bytes von niedriger priorisierten gesendet.
Verschiedene Gruppen sollten für die Zwecke der Bandbreitenzuweisung gleich behandelt werden — wobei die genaue Art und Weise, wie die Bandbreite zwischen Gruppen aufgeteilt wird, implementierungsspezifisch 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 festlegen können, wenn Sie createWritable() aufrufen, um den beschreibbaren Stream zu erstellen, den Wert aus dem Stream auszulesen und ihn dann zu ä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 |