Sec-CH-UA ヘッダー
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
HTTP の Sec-CH-UA リクエストヘッダーは、ユーザーエージェントのクライアントヒントの一種であり、ユーザーエージェントのブランド名およびメジャーバージョン情報を提供します。
Sec-CH-UA ヘッダーは、ブラウザーに関連付けられたそれぞれのブランドとその主要なバージョンを、カンマ区切りのリストとして提供します。
したがって、サーバーはこのヘッダーを利用して、共通するブランドだけでなく、それぞれのバージョンにおける具体的なカスタマイズ内容に基づいて、レスポンスをカスタマイズすることができます。
Sec-CH-UA は低エントロピーヒントです。
ユーザーエージェントの権限ポリシーによってブロックされていない限り、サーバーが Accept-CH を送信してオプトインする必要はなく、デフォルトで送信されます。
ヘッダーには、任意の位置、任意の名前で、「偽の」ブランドを含めることができます。 これは、サーバーが未知のユーザーエージェントを即座に拒否することを防ぐために設計された機能であり、ユーザーエージェントにブランド ID について虚偽の情報を報告させることを目的としています。
メモ:
Sec-CH-UA-Full-Version-List ヘッダーは Sec-CH-UA と同じですが、それぞれのブランドの主要バージョン番号ではなく、完全なバージョン番号を記載しています。
| ヘッダー種別 | リクエストヘッダー, クライアントヒント |
|---|---|
| 禁止リクエストヘッダー | はい（Sec- 接頭辞） |
構文
Sec-CH-UA: "<brand>";v="<significant version>", …
この値は、ユーザーエージェントのブランド一覧に含まれるブランドと、それに関連付けられたメジャーバージョン番号をカンマ区切りで列挙したものです。
ディレクティブ
<brand>-
"Chromium" や "Google Chrome" といったユーザーエージェントに関連付けられたブランド、あるいは
"Not A;Brand"のような意図的に誤ったブランド。 <significant version>-
ウェブ上で公開されている、識別可能な機能に関連付けられた「マーケティング用」のバージョン番号。
解説
ブランドとは、Chromium、Opera、Google Chrome、Microsoft Edge、Firefox、Safari などのユーザーエージェントの商品名のことです。
1 つのユーザーエージェントには、複数のブランドが関連付けられている場合があります。
例えば、Opera、Chrome、Edge はすべて Chromium をベースとしており、Sec-CH-UA ヘッダーには両方のブランドが指定されます。
significant version とは、そのブランドのメジャーリリースを判別するために使用される「マーケティング用」のバージョン識別子です。 例えば、完全なバージョン番号が "96.0.4664.45" である Chromium ビルドの場合、significant version 番号は "96" となります。
例
様々な Sec-CH-UA ブランド
Sec-CH-UA は低エントロピーヒントです。
ユーザーエージェントの権限ポリシーによってブロックされていない限り、サーバーが Accept-CH を送信してオプトインする必要はなく、デフォルトで送信されます。
Chromium、Chrome、Edge、Opera の各デスクトップブラウザーの文字列を下記に示します。 これらはすべて "Chromium" というブランドを共有していますが、その由来を示す追加のブランド名も付いている点に注意してください。 また、意図的に誤ったブランド文字列も存在し、これは任意の位置に現れる可能性があり、テキストの内容も異なります。
Sec-CH-UA: "(Not(A:Brand";v="8", "Chromium";v="98"
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Google Chrome";v="96"
Sec-CH-UA: " Not A;Brand";v="99", "Chromium";v="96", "Microsoft Edge";v="96"
Sec-CH-UA: "Opera";v="81", " Not;A Brand";v="99", "Chromium";v="95"
仕様書
| 仕様書 |
|---|
| User-Agent Client Hints # sec-ch-ua |