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

View in English Always switch to English

Sec-CH-UA-Full-Version-List ヘッダー

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more browser support for this feature? Tell us why.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

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

HTTP の Sec-CH-UA-Full-Version-List リクエストヘッダー はユーザーエージェントクライアントヒントで、このユーザーエージェントのブランドと完全なバージョン情報を提供します。

Sec-CH-UA-Full-Version-List ヘッダーは、ブラウザーに関連付けられたそれぞれのブランドのブランド名および完全なバージョン情報を、カンマ区切りのリストとして指定します。

ヘッダーには、任意の位置に、任意の名称の「偽の」ブランドを含めることができます。 これは、サーバーが未知のユーザーエージェントを即座に拒否することを防ぐために設計された機能であり、ユーザーエージェントにブランド ID について虚偽の情報を報告させることを目的としています。

メモ: これは Sec-CH-UA と似ていますが、それぞれのブランドの主要なバージョン番号ではなく、完全なバージョン番号を記載します。

ヘッダー種別 リクエストヘッダー, クライアントヒント
禁止リクエストヘッダー はい (Sec- 接頭辞)

構文

http
Sec-CH-UA-Full-Version-List: "<brand>";v="<full version>", …

この値は、ユーザーエージェントのブランド一覧に含まれるブランド名と、それに関連付けられた完全なバージョン番号をカンマ区切りで列挙したものです。

ディレクティブ

<brand>

"Chromium", "Google Chrome" など、ユーザーエージェントに関連付けられたブランド。 このブランド名は、" Not A;Brand" や "(Not(A:Brand" のように、同様に意図的に誤った表記となっていることがあります(実際の値は時間経過に伴う変化により予測不能であると想定されています)。

<full version>

完全なバージョン番号、例えば 98.0.4750.0 などです。

解説

ブランドとは、Chromium、Opera、Google Chrome、Microsoft Edge、Firefox、Safari などのユーザーエージェントの商品名のことです。 1 つのユーザーエージェントには、複数のブランドが関連付けられている場合があります。 例えば、Opera、Chrome、Edge はすべて Chromium をベースとしており、Sec-CH-UA-Full-Version-List ヘッダーには両方のブランドが含まれます。

このヘッダーにより、サーバーは、共有ブランドと、それぞれのビルドにおける具体的なカスタマイズ設定の両方に基づいて、レスポンスをカスタマイズすることができます。

例

Sec-CH-UA-Full-Version-List の使用

サーバーは、クライアントからの任意のリクエストに対するレスポンスに Accept-CH を含めることで、Sec-CH-UA-Full-Version-List ヘッダーをリクエストします。この際、希望するヘッダー名をトークンとして使用します。

http
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Full-Version-List

クライアントは、このヒントを提供し、下記に示すように、その後のリクエストに Sec-CH-UA-Full-Version-List ヘッダーを追加することを選択できます。

http
GET /my/page HTTP/1.1
Host: example.site

Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Full-Version-List: " Not A;Brand";v="99.0.0.0", "Chromium";v="98.0.4750.0", "Google Chrome";v="98.0.4750.0"
Sec-CH-UA-Platform: "Linux"

仕様書

仕様書
User-Agent Client Hints
# sec-ch-ua-full-version-list

ブラウザーの互換性

関連情報