HTTP クライアントヒント

サーバーはクライアントヒントに対応していることを知らせる必要があります。 Accept-CH を使用して、受信したいヒントを指定します。 クライアントヒントに対応しているクライアントは、Accept-CH ヘッダーを受け取ると、列挙されているクライアントヒントヘッダーの一部または全部を、それ以降のリクエストに追加することを選択することができます。

例えば、下記のレスポンスの Accept-CH の後で、クライアントは Width、 Downlink、Sec-CH-UA ヘッダーを以降のすべてのリクエストに付加することができます。

Accept-CH: Width, Downlink, Sec-CH-UA

この手法は、サーバーが有益に処理することができる情報のみをリクエストされるという点で効率的です。 また、どの情報を安全に共有できるかを決めるのはクライアント次第という点で、比較的「プライバシー保護」にもなっています。

リクエストされなかった場合、クライアントイベントによって送信される可能性のある、低エントロピーのクライアントヒントヘッダーも少しあります。

<meta http-equiv="Accept-CH" content="Width, Downlink, Sec-CH-UA" />

レスポンスで送信されるリソースを決定するクライアントヒントは、一般に、影響を受けるレスポンスの Vary ヘッダーに記載すべきです。 これにより、ヒントヘッダーの値が異なる場合に、それぞれ別のリソースがキャッシュされることが保証されます。

Vary: Accept, Width, ECT

値が頻繁に変更されるクライアントヒントヘッダについては、 Vary を指定しないか、 他の方法を使用したほうがよいでしょう。これは、リソースを効果的にキャッシュできなくしてしまうからです。( それぞれの固有の値に対して、新しいキャッシュ項目が作成されます)。 これは特に Downlink や RTT のようなネットワーククライアントヒントに当てはまります。 詳細な情報は、HTTP キャッシュ > レスポンスの変化 を参照してください。

サーバーは、取得したいクライアントヒントヘッダーを Accept-CH レスポンスヘッダで指定します。 ユーザーエージェントはリクエストされたクライアントヒントヘッダー、または少なくともそのサーバーと共有するサブセットを、現在の閲覧セッションにおけるそれ以降のすべてのリクエストに付加します。

言い換えれば、特定のヒント集合に対するリクエストは、ブラウザーが終了するまで期限切れになりません。

サーバーが受け取りたいクライアントヒントの集合を置き換えるには、 Accept-CH レスポンスヘッダーを新しいリストで再送することで行うことができます。 例えば、何もリクエストしないようにするには、空のリストで Accept-CH を送ります。

クライアントヒントは、高エントロピーと低エントロピーのヒントに大別されます。

低エントロピーヒントは、特定のユーザーを「フィンガープリント」（識別）するために使用される可能性がある情報を多くは与えないものです。 これらは、サーバーの Accept-CH レスポンスヘッダーに関係なく、許可ポリシーに応じて、すべてのクライアントリクエストで既定で送信される可能性があります。 これらのヒントには Save-Data, Sec-CH-UA, Sec-CH-UA-Mobile, Sec-CH-UA-Platform などがあります。

高エントロピーヒントは、ユーザーのフィンガープリントに使用される可能性のある、より多くの情報を保持することができるものです。したがって、そのため、提供するかどうかをユーザーエージェントが選択できるような形で制限を設けています。 その決定はユーザーの環境設定、許可リクエスト、または許可ポリシーに基づいて行われる可能性があります。 低エントロピーヒントでないすべてのクライアントヒントは、高エントロピーヒントとみなされます。

「重要なクライアントヒント」とは、レスポンスを適用することでレンダリングされるページが大きく変化する可能性があるもので、不快感を与えたりユーザビリティに影響を与える可能性があるため、コンテンツがレンダリングされる前に適用する必要があるものです。 例えば、Sec-CH-Prefers-Reduced-Motion は一般に重要なヒントとして扱われます。なぜなら、アニメーションの動作に著しく影響を与える可能性があり、この環境設定を選んだユーザーはそれを設定する必要があるためです。

サーバーは Critical-CH レスポンスヘッダーを Accept-CH と共に使用することで、 受け入れられたクライアントヒントが重要なクライアントヒントで もあることを指定することができます（Critical-CH のヘッダーは Accept-CH にも現れる必要があります）。 Critical-CH のレスポンスを受け取ったユーザーエージェントは、示された Crtical ヘッダーが元のリクエストで送信されたかどうかを調べなければなりません。送信されていなかった場合、ユーザーエージェントはページをレンダリングせずに、リクエストを再試行します。 この手法は、重要なクライアントヒントを使用して設定されたクライアント環境設定が、たとえ最初のリクエストに含まれていなかったとしても、あるいはサーバーの設定が変更されたとしても、常に使用されることを保証するものです。

例えばこの例では、サーバーは Accept-CH によって Sec-CH-Prefers-Reduced-Motion を受け入れることをクライアントに指示し、 Critical-CH は Sec-CH-Prefers-Reduced-Motion が重要なクライアントヒントと見なされることを指定するのに使用されます。

HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Motion
Vary: Sec-CH-Prefers-Reduced-Motion
Critical-CH: Sec-CH-Prefers-Reduced-Motion

Sec-CH-Prefers-Reduced-Motion は元のリクエストにはなかった重要なヒントなので、クライアントは自動的にリクエストを再試行します。今度は Sec-CH-Prefers-Reduced-Motion を通じて、動きの少ないアニメーションを好むユーザーであることをサーバーに指示します。

GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Motion: "reduce"

ユーザーエージェント (UA) クライアントヒントヘッダーにより、サーバーはユーザーエージェント（ブラウザー）、オペレーティングシステム、および機器に応じてレスポンスを変化させることができるようになります。 ヘッダーには Sec-CH-UA, Sec-CH-UA-Arch, Sec-CH-UA-Bitness, Sec-CH-UA-Full-Version-List, Sec-CH-UA-Full-Version, Sec-CH-UA-Mobile, Sec-CH-UA-Model, Sec-CH-UA-Platform, Sec-CH-UA-Platform-Version などがあります。

クライアントヒントは、ウェブページの JavaScript でユーザーエージェントクライアントヒント API によって使用することができます。

ユーザー環境設定メディア特性クライアントヒントは、配色や動きの縮小などの CSS メディア特性に対するユーザーエージェントの環境設定に基づいて、サーバーがレスポンスを変更することを可能にします。 ヘッダーには Sec-CH-Prefers-Reduced-Motion, Sec-CH-Prefers-Color-Scheme などがあります。

端末クライアントヒントは、利用できるメモリーや画面のプロパティなど、端末の特性に応じてサーバーがレスポンスを変化させることを可能にします。 ヘッダーには Device-Memory, DPR, Width, Viewport-Width などがあります。

ネットワーククライアントヒントにより、サーバーはユーザーの選択、ネットワーク帯域、レイテンシーに基づいてレスポンスを変化させることができます。 ヘッダーには Save-Data, Downlink, ECT, RTT などがあります。

• クライアントヒントのヘッダー
• Vary HTTP ヘッダー
• Client Hints Infrastructure（英語）
• ユーザーエージェントクライアントヒント API
• Improving user privacy and developer experience with User-Agent Client Hints (web.dev)（英語）