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

View in English Always switch to English

Sec-CH-UA-Form-Factors ヘッダー

利用可能性は限定的

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

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

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

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

HTTP の Sec-CH-UA-Form-Factors リクエストヘッダー はユーザーエージェントクライアントヒントで、ユーザーエージェントの端末のフォームファクターに関する情報を提供します。

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

構文

http
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
HTTP/1.1 200 OK
Accept-CH: Sec-CH-UA-Form-Factors

クライアントは、このヒントを提供することを選択することができます。その後、リクエストに Sec-CH-UA-Form-Factors ヘッダーを追加することができます。 例えば、クライアントは次のようにヘッダーを追加することができます。

http
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

ブラウザーの互換性

関連情報