WebTransportDatagramDuplexStream: Eigenschaft outgoingMaxBufferedDatagrams
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 Eigenschaft outgoingMaxBufferedDatagrams der Schnittstelle WebTransportDatagramDuplexStream gibt die maximale Anzahl ausgehender Datagramme an, die bei jedem WebTransportDatagramsWritable zum Senden in die Warteschlange gestellt werden können, bevor Gegendruck angewendet wird.
Wert
Eine Ganzzahl.
Der Anfangswert wird vom Browser festgelegt.
Wenn die Eigenschaft auf 0 gesetzt wird, erhält sie den Wert 1.
Beschreibung
Jedes von createWritable() zurückgegebene WebTransportDatagramsWritable hat eine eigene Warteschlange mit Datagrammen, die auf das Senden warten.
Wenn die Anzahl der Datagramme in einer Warteschlange diesen Wert erreicht, wendet das Writable Gegendruck an: Das von der Methode write() des Writers zurückgegebene Promise und dessen ready-Promise werden erst erfüllt, wenn in der Warteschlange Platz für ein weiteres Datagramm ist.
Datagramme in der Warteschlange werden nicht verworfen, weil die Warteschlange voll ist. Sie können jedoch trotzdem verfallen, wenn outgoingMaxAge gesetzt ist.
Wird dieser Wert erhöht, wird der Gegendruck für jedes Writable aufgehoben, dessen Warteschlange nun kürzer als der neue Wert ist.
Diese Eigenschaft ersetzt die veraltete Eigenschaft outgoingHighWaterMark.
Beispiele
Maximale Anzahl gepufferter ausgehender Datagramme festlegen
In diesem Beispiel wird die ausgehende Warteschlange jedes Writables so eingestellt, dass sie bis zu 100 Datagramme aufnehmen kann. Anschließend wird der Wert protokolliert.
const url = "https://example.com:4999/wt";
async function initTransport(url) {
// Initialize transport connection
const transport = new WebTransport(url);
// The connection can be used once ready fulfills
await transport.ready;
const datagrams = transport.datagrams;
// set outgoingMaxBufferedDatagrams
datagrams.outgoingMaxBufferedDatagrams = 100;
// get outgoingMaxBufferedDatagrams
console.log(datagrams.outgoingMaxBufferedDatagrams);
}
Spezifikationen
| Spezifikation |
|---|
| WebTransport # dom-webtransportdatagramduplexstream-outgoingmaxbuffereddatagrams |