Sec-CH-Prefers-Reduced-Transparency ヘッダー
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
HTTP の Sec-CH-Prefers-Reduced-Transparency リクエストヘッダーはユーザーエージェントクライアントヒントで、透過性の低減を推奨します。
サーバーが Accept-CH ヘッダーを介して、Sec-CH-Prefers-Reduced-Transparency を受け入れることをクライアントに通知した場合、クライアントはこのヘッダーを含めて応答することで、ユーザーが透明度の低減を希望していることを示すことができます。サーバーは、コンテンツの透明度を下げるために、CSS や画像など、適切に調整されたコンテンツをクライアントに送信することができます。
このヘッダーは、prefers-reduced-transparency メディアクエリーをモデルにしています。
| ヘッダー種別 | リクエストヘッダー, クライアントヒント |
|---|---|
| 禁止リクエストヘッダー | はい (Sec- 接頭辞) |
構文
Sec-CH-Prefers-Reduced-Transparency: <preference>
ディレクティブ
<preference>-
ユーザーエージェントによる透明度の縮小に関する環境設定。これは多くの場合、基盤となるオペレーティングシステムの設定に基づいています。このディレクティブの値は、
no-preferenceまたはreduceのどちらかになります。
例
Sec-CH-Prefers-Reduced-Transparency の使用
クライアントはサーバーに対して最初のリクエストを送信します。
GET / HTTP/1.1
Host: example.com
サーバーは応答し、Accept-CH を通じてクライアントに対し、Sec-CH-Prefers-Reduced-Transparency を受け入れることを指示します。この例では Critical-CH も使用されており、Sec-CH-Prefers-Reduced-Transparency が重要なクライアントヒントと考えていることを示しています。
HTTP/1.1 200 OK
Content-Type: text/html
Accept-CH: Sec-CH-Prefers-Reduced-Transparency
Vary: Sec-CH-Prefers-Reduced-Transparency
Critical-CH: Sec-CH-Prefers-Reduced-Transparency
メモ:
また、Sec-CH-Prefers-Reduced-Transparency を Vary ヘッダーに指定しています。これは、URL が同じであっても、このヘッダーの値によって配信されるコンテンツが異なることをブラウザーに示すためです。これにより、ブラウザーは既存のキャッシュされたレスポンスをそのまま使用せず、このレスポンスを別個のキャッシュとして保存するようになります。Critical-CH ヘッダーに掲載されているそれぞれのヘッダーは、Accept-CH および Vary ヘッダーにも同時に存在している必要があります。
クライアントは（上記で Critical-CH が指定されているため）リクエストを自動的に再試行し、Sec-CH-Prefers-Reduced-Transparency を通じて、透明性を縮小することをユーザーの環境設定で推奨していることをサーバーに指示します。
GET / HTTP/1.1
Host: example.com
Sec-CH-Prefers-Reduced-Transparency: "reduce"
サーバーからのレスポンスで Accept-CH が変更され、サーバー側で対応できなくなったことを示さない限り、クライアントは現在のセッションにおけるその後のリクエストにこのヘッダーを記載します。
仕様書
| 仕様書 |
|---|
| User Preference Media Features Client Hints Headers # sec-ch-prefers-reduced-transparency |
ブラウザーの互換性
関連情報
- クライアントヒント
- ユーザーエージェントクライアントヒント API
Accept-CH- HTTP キャッシュ: Vary および
Varyヘッダー - Improving user privacy and developer experience with User-Agent Client Hints (developer.chrome.com)