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

View in English Always switch to English

WebTransport: protocol プロパティ

Baseline 2026
最近利用可能

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

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

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

protocol は WebTransport インターフェイスの読み取り専用プロパティで、サーバーが選択したアプリケーション固有のプロトコルを返します。

この値は protocols コンストラクターオプションで提示したプロトコルの中から選択されます。 値は ready プロミスが履行された時点で設定されます。 protocols を使用しなかった場合、またはサーバーが提示されたプロトコルを選択しなかった場合、空文字列になります。

値

文字列です。 デフォルト値は "" です。

例

ネゴシエーションされたプロトコルを要求して読み取る

この例では、候補となるプロトコル群を要求し、サーバーが選択したプロトコルを読み取る方法を示します。

js
const url = "https://example.com:4999/wt";

async function initTransport(url) {
  const transport = new WebTransport(url, {
    protocols: ["chat", "file-transfer"],
  });

  try {
    // ready が履行されると接続を使用できる
    await transport.ready;
    console.log(transport.protocol); // 例: "chat"、または選択されなかった場合は ""
    return transport;
  } catch (error) {
    // 提示したプロトコルに対応していない場合、ready は拒否されることがある
    console.error(`接続に失敗しました: ${error}`);
  }
}

initTransport(url);

仕様書

仕様書
WebTransport
# dom-webtransport-protocol

ブラウザーの互換性