本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2026年4月7日(火)更新: 2026年11月9日(月)約8分で読めます

WebTransportでQUIC(HTTP/3)の双方向通信をする

WebTransportは、QUIC(HTTP/3)の上でブラウザとサーバーが双方向にやり取りするAPIです。WebSocketと違い、独立したストリームを複数開け、再送しないデータグラムも送れます。自己署名の証明書でのつなぎ方も説明します。

Newly availableWebTransport2026年〜
  • Chrome97
  • Edge97
  • Firefox114
  • Safari26.4

はじめに

WebTransportは、QUIC(HTTP/3)の上で、ブラウザとサーバーがデータを双方向にやり取りするAPIです。1本の接続に独立したストリームをいくつも開け、届かなくても再送しないデータグラムも送れます。Safari 26.4が対応して、Baseline 2026に入りました。

チャットや通知のような少量のテキストのやり取りには、サーバーのライブラリやホスティングがそろったWebSocketを使います。WebSocketはTCPの上で1本のメッセージ列しか持てないので、一部のデータが遅れると後のデータまで待たされます。遅れたデータを待たずにほかの流れを進めたい通信や、ゲームの座標のように古い値を捨ててよい通信は、WebTransportで書けます。

使い方

WebTransportは、HTTPSで配ったページのようなSecure Contextでだけ使え、Web Workerからも使えます。渡すURLはhttpsで始めます。httpのURLや、#chatのようなフラグメントの付いたURLを渡すと、コンストラクタがSyntaxErrorを投げます。ポート番号を省くと、httpsの既定の443番につなぎます。

コネクションを開く

WebTransportのコンストラクタにURLを渡し、readyのPromiseが解決すると、接続ができます。

ts
const transport = new WebTransport('https://example.com:4433/chat');

await transport.ready;
console.log('接続完了');

// 切断時の処理
transport.closed
  .then(() => console.log('正常に切断されました'))
  .catch((err) => console.error('切断時にエラー', err));

切断したいときはtransport.close()を呼びます。

手元のサーバーに開発用の自己署名の証明書でつなぐときは、serverCertificateHashesに証明書のSHA-256のハッシュを渡します。渡さないと、readyがWebTransportErrorで拒否されます。

ts
const transport = new WebTransport('https://localhost:4433/chat', {
  serverCertificateHashes: [{ algorithm: 'sha-256', value: certHash }],
});

certHashは、openssl x509 -in cert.pem -outform der | openssl dgst -sha256 -binaryで出る32バイトをUint8Arrayにしたものです。仕様では、ハッシュで許す証明書はECDSAの鍵で、有効期間が2週間以内のものに限られます。

データグラムの送受信

データグラムは、順序も再送も無い、もっとも軽い送受信の方法です。届かなくても次の値で上書きすればよい、入力中の表示やキャラクターの座標のようなデータで使います。

データグラムはtransport.datagramsのreadableで受け取り、createWritable()で作った書き込み用のストリームで送ります。どちらも標準のStreams APIなので、getReader()やgetWriter()でそのまま扱えます。

ただし、ChromeはcreateWritable()を持たず、writableだけを持ちます。Safariは逆にwritableを持たないので、transport.datagrams.writable.getWriter()と書くとTypeErrorになります。Firefoxは両方を持ちます。そこで、createWritable()が無いときだけwritableを使います。

js
// 送信
const writable =
  transport.datagrams.createWritable?.() ?? transport.datagrams.writable;
const writer = writable.getWriter();
await writer.write(new Uint8Array([1, 2, 3]));
writer.releaseLock();

// 受信
const reader = transport.datagrams.readable.getReader();
while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  console.log('受信:', value);
}

1つのデータグラムで送れる大きさは、transport.datagrams.maxDatagramSizeで分かります。値はブラウザによって大きく違い、Chromeは1211、Firefoxは1024、Safariは65535を返します。

単方向ストリーム

ストリームはデータグラムと違い、順序が保たれ、欠けたデータは再送されます。一方向に送るだけでよいときは、単方向(Unidirectional)のストリームを使います。

ts
const stream = await transport.createUnidirectionalStream();
const writer = stream.getWriter();
await writer.write(new Uint8Array([10, 20, 30]));
await writer.close();

サーバーから開かれた単方向のストリームは、transport.incomingUnidirectionalStreamsから受け取ります。

ts
const reader = transport.incomingUnidirectionalStreams.getReader();
while (true) {
  const { value: stream, done } = await reader.read();
  if (done) break;
  // stream は ReadableStream
  const streamReader = stream.getReader();
  // ...読み込み処理
}

双方向ストリーム

リクエストとレスポンスのように両方向にやり取りするときは、双方向(Bidirectional)のストリームを使います。1つのWebTransportBidirectionalStreamが、readableとwritableの両方を持ちます。

送信と受信は独立しているので、送信の完了を待たずに受信のループを回せます。

ts
const stream = await transport.createBidirectionalStream();

// 受信ループを先に起動しておく
const receiveTask = (async () => {
  const reader = stream.readable.getReader();
  while (true) {
    const { value, done } = await reader.read();
    if (done) break;
    console.log('受信:', value);
  }
})();

// 受信ループの裏で送信する
const writer = stream.writable.getWriter();
await writer.write(new Uint8Array([1, 2, 3]));
await writer.close();

await receiveTask;

ストリームはいくつも並行して開けるので、ファイルの転送と制御のメッセージを別々のストリームで流すような設計も書けます。

おわりに

WebTransportを使うと、1本の接続に独立したストリームをいくつも開き、再送しないデータグラムも送れます。少量のテキストのやり取りにはWebSocketを使い、遅れを待たせたくない通信や、古い値を捨ててよい通信のときにWebTransportを選びます。