WebTransportDatagramDuplexStream
Baseline
2026
*
Neu verfügbar
Seit March 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
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 WebTransportDatagramDuplexStream-Interface der WebTransport API repräsentiert einen Duplex-Stream, der für den unzuverlässigen Transport von Datagrammen zwischen Client und Server verwendet werden kann. Es bietet Zugriff auf einen ReadableStream zum Lesen eingehender Datagramme, einen WritableStream zum Schreiben ausgehender Datagramme sowie verschiedene Einstellungen und Statistiken im Zusammenhang mit dem Stream.
Darauf kann über die WebTransport.datagrams-Eigenschaft zugegriffen werden.
"Unzuverlässig" bedeutet, dass die Datenübertragung nicht garantiert ist und auch keine Ankunft in einer bestimmten Reihenfolge. Dies ist in einigen Situationen in Ordnung und bietet eine sehr schnelle Zustellung. Beispielsweise könnten Sie regelmäßige Spielstatus-Updates übertragen, bei denen jede Nachricht die vorherige überschreibt und die Reihenfolge nicht wichtig ist.
Instanzeigenschaften
incomingHighWaterMark-
Ruft die Hochwasser-Marke für eingehende Datenblöcke ab oder legt sie fest — das ist die maximale Größe, in Blöcken, die die interne Warteschlange des eingehenden
ReadableStreamerreichen kann, bevor sie als voll gilt. Weitere Informationen finden Sie unter Interne Warteschlangen und Warteschlangenstrategien. incomingMaxAge-
Ruft die maximale Lebensdauer für eingehende Datagramme in Millisekunden ab oder legt sie fest. Gibt
nullzurück, wenn keine maximale Lebensdauer festgelegt wurde. maxDatagramSizeSchreibgeschützt-
Gibt die maximale zulässige Größe ausgehender Datagramme in Bytes zurück, die in
writablegeschrieben werden können. outgoingHighWaterMark-
Ruft die Hochwasser-Marke für ausgehende Datenblöcke ab oder legt sie fest — das ist die maximale Größe, in Blöcken, die die interne Warteschlange des ausgehenden
WritableStreamerreichen kann, bevor sie als voll gilt. Weitere Informationen finden Sie unter Interne Warteschlangen und Warteschlangenstrategien. outgoingMaxAge-
Ruft die maximale Lebensdauer für ausgehende Datagramme in Millisekunden ab oder legt sie fest. Gibt
nullzurück, wenn keine maximale Lebensdauer festgelegt wurde. readableSchreibgeschützt-
Gibt eine
ReadableStream-Instanz zurück, die zum Lesen eingehender Datagramme aus dem Stream verwendet werden kann. writableSchreibgeschützt Veraltet Nicht standardisiert-
Gibt eine
WritableStream-Instanz zurück, die zum Schreiben ausgehender Datagramme in den Stream verwendet werden kann.
Beispiele
Schreiben ausgehender Datagramme
Die writable-Eigenschaft gibt ein WritableStream-Objekt zurück, in das Sie Daten mithilfe eines Writers schreiben können, um sie an den Server zu übertragen:
const writer = transport.datagrams.writable.getWriter();
const data1 = new Uint8Array([65, 66, 67]);
const data2 = new Uint8Array([68, 69, 70]);
writer.write(data1);
writer.write(data2);
Lesen eingehender Datagramme
Die readable-Eigenschaft gibt ein ReadableStream-Objekt zurück, das Sie verwenden können, um Daten vom Server zu empfangen:
async function readData() {
const reader = transport.datagrams.readable.getReader();
while (true) {
const { value, done } = await reader.read();
if (done) {
break;
}
// value is a Uint8Array.
console.log(value);
}
}
Spezifikationen
| Spezifikation |
|---|
| WebTransport # webtransportdatagramduplexstream |