WebTransport: datagrams-Eigenschaft
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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 schreibgeschützte Eigenschaft datagrams des WebTransport-Interfaces gibt eine WebTransportDatagramDuplexStream-Instanz zurück, die verwendet werden kann, um Datagramme zu senden und zu empfangen — unzuverlässige Datenübertragung.
"Unzuverlässig" bedeutet, dass die Übertragung von Daten nicht garantiert ist und auch die Reihenfolge des Eintreffens nicht festgelegt ist. Dies ist in einigen Situationen unproblematisch und ermöglicht eine sehr schnelle Lieferung. Beispielsweise möchten Sie möglicherweise regelmäßige Spielzustandsaktualisierungen übermitteln, bei denen jede Nachricht die letzte ersetzt, die angekommen ist, und bei denen die Reihenfolge unwichtig ist.
Wert
Ein WebTransportDatagramDuplexStream-Objekt.
Beispiele
Ein ausgehendes Datagramm schreiben
Die WebTransportDatagramDuplexStream.writable-Eigenschaft gibt ein WritableStream-Objekt zurück, in das Sie mithilfe eines Writers Daten 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);
Ein eingehendes Datagramm lesen
Die WebTransportDatagramDuplexStream.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
| Specification |
|---|
| WebTransport # dom-webtransport-datagrams |
Browser-Kompatibilität
BCD tables only load in the browser