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> |