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