Sec-CH-UA-Form-Factors ヘッダー
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
Want more browser support for this feature? Tell us why.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。
HTTP の Sec-CH-UA-Form-Factors リクエストヘッダー はユーザーエージェントクライアントヒントで、ユーザーエージェントの端末のフォームファクターに関する情報を提供します。
| ヘッダー種別 | リクエストヘッダー, クライアントヒント |
|---|---|
| 禁止リクエストヘッダー | はい (Sec- 接頭辞) |
構文
Sec-CH-UA-Form-Factors: <form-factor>
Sec-CH-UA-Form-Factors: <form-factor>, …, <form-factor>
ディレクティブ
<form-factor>-
一般的な端末のフォームファクターを示す文字列。 該当するすべてのフォームファクターを含めることができます。 許容される値の意味は次のとおりです。
"Desktop"-
パーソナルコンピューター上で実行されるユーザーエージェント。
"Automotive"-
車両に埋め込まれたユーザーエージェント。この場合、ユーザーが車両を運転する責任を持ち、操作能力には制限がある場合がある。
"Mobile"-
通常、ユーザーが身につけて持ち歩く、小型のタッチ操作対応端末。
"Tablet"-
"Mobile"よりも大きく、通常はユーザーが持ち歩かないタッチ操作型の端末。 "XR"-
ユーザーの周囲の環境を拡張または置き換える没入型端末。
"EInk"-
画面の更新が遅く、色解像度が制限されている、あるいはまったくないことを特徴とする端末。
"Watch"-
画面が非常に小さい(通常は 2 インチ未満)モバイル端末で、ユーザーがすばやく目をやって確認できるような持ち方をするもの。
例
>Sec-CH-UA-Form-Factors の使用
サーバーは、クライアントからのリクエストに対するレスポンスに Accept-CH を含めることで、Sec-CH-UA-Form-Factors ヘッダーを要求します。この際、希望するヘッダー名をトークンとして使用します。
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Form-Factors
クライアントは、このヒントを提供することを選択することができます。その後、リクエストに Sec-CH-UA-Form-Factors ヘッダーを追加することができます。
例えば、クライアントは次のようにヘッダーを追加することができます。
GET /my/page HTTP/1.1
Host: example.site
Sec-CH-UA-Mobile: ?0
Sec-CH-UA-Form-Factors: "EInk"
この場合、"EInk" は、その端末が画面の更新速度が遅く、色解像度が制限されているということの意味があります。そのため、このヒントに応じてレスポンスが異なる場合があります。
仕様書
| 仕様書 |
|---|
| User-Agent Client Hints> # sec-ch-ua-form-factors> |
ブラウザーの互換性
関連情報
- クライアントヒント
- ユーザーエージェントクライアントヒント API
Accept-CH- HTTP キャッシュ: Vary および
Varyヘッダー - Improving user privacy and developer experience with User-Agent Client Hints - developer.chrome.com