WebTransport: incomingUnidirectionalStreams プロパティ
Baseline 2026>
最近利用可能
2026年3月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
メモ: この機能はウェブワーカー内で利用可能です。
incomingUnidirectionalStreams は WebTransport インターフェイスの読み取り専用プロパティで、サーバーが開いた 1 つ以上の単方向ストリームを表します。WebTransportReceiveStream オブジェクトの ReadableStream を返し、それぞれを使ってサーバーから信頼性のある形でデータを読み取ることができます。
「信頼性がある」とは、データの転送と順序が保証されることを意味します。この方式では datagrams よりもデータの配信が遅くなります(ただし WebSockets よりは速いです)が、チャットアプリケーションのように信頼性と順序が重要な状況で必要です。
値
WebTransportReceiveStream オブジェクトの ReadableStream です。
例
最初の関数で ReadableStream から WebTransportReceiveStream オブジェクトを読み取ります。各オブジェクトを別の関数に渡し、そのストリームからデータを読み取ります。
js
async function receiveUnidirectional() {
const uds = transport.incomingUnidirectionalStreams;
const reader = uds.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) {
break;
}
// value は WebTransportReceiveStream のインスタンス
await readData(value);
}
}
async function readData(receiveStream) {
const reader = receiveStream.getReader();
while (true) {
const { done, value } = await reader.read();
if (done) {
break;
}
// value は Uint8Array
console.log(value);
}
}
仕様書
| 仕様書 |
|---|
| WebTransport> # dom-webtransport-incomingunidirectionalstreams> |