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

View in English Always switch to English

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

ブラウザーの互換性

関連情報