このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

WebTransport: incomingBidirectionalStreams プロパティ

Baseline 2026
最近利用可能

2026年3月以降、この機能は最新のバージョンの端末およびブラウザーで動作します。古い端末やブラウザーでは動作しないことがあります。

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

メモ: この機能はウェブワーカー内で利用可能です。

incomingBidirectionalStreams は WebTransport インターフェイスの読み取り専用プロパティで、サーバーが開いた 1 つ以上の双方向ストリームを表します。WebTransportBidirectionalStream オブジェクトの ReadableStream を返し、それぞれを使ってサーバーから信頼性のある形でデータを読み取り、サーバーへ書き戻すことができます。

「信頼性がある」とは、データの転送と順序が保証されることを意味します。この方式では datagrams よりもデータの配信が遅くなります(ただし WebSockets よりは速いです)が、チャットアプリケーションのように信頼性と順序が重要な状況で必要です。

値

WebTransportBidirectionalStream オブジェクトの ReadableStream です。

例

最初の関数で ReadableStream から WebTransportBidirectionalStream オブジェクトを読み取ります。それぞれのオブジェクトの WebTransportBidirectionalStream.readable と WebTransportBidirectionalStream.writable の値を別の関数に渡し、各ストリームからの読み取りと書き込みを行います。

js
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

ブラウザーの互換性

関連情報