WebTransport: incomingUnidirectionalStreams property
The incomingUnidirectionalStreams
read-only property of the WebTransport
interface represents one or more unidirectional streams opened by the server. Returns a ReadableStream
of WebTransportReceiveStream
objects. Each one can be used to reliably read data from the server.
"Reliable" means that transmission and order of data are guaranteed. This provides slower delivery (albeit faster than with WebSockets) than datagrams
, but is needed in situations where reliability and ordering are important, like chat applications.
Value
Examples
An initial function is used to read the WebTransportReceiveStream
objects from the ReadableStream
. Each object is then passed to another function to read from those streams.
async function receiveUnidirectional() {
const uds = transport.incomingUnidirectionalStreams;
const reader = uds.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) {
break;
}
await readData(value);
}
}
async function readData(receiveStream) {
const reader = receiveStream.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) {
break;
}
console.log(value);
}
}
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
incomingUnidirectionalStreams |
97 |
97 |
114 |
No |
83 |
No |
97 |
97 |
114 |
68 |
No |
18.0 |
See also