top
logo
custom iconリソースの概要HOT
custom icon機能の概要
language-switch
クライアントヒントは、Webブラウザがクライアントデバイスとブラウザに関する詳細情報をWebサーバーに送信できるようにする、一連のHTTPヘッダーおよびJavaScript APIです。これらはUser-Agentに代わるものであり、Webサーバーに対して、信頼性の低いUser-Agent文字列に基づく検出やブラウザフィンガープリンティング技術に依存せずに、クライアントコンテンツを最適化するための標準化された手段を提供します。
User-Agent文字列
user-Agent
loadingloading...
User-Agent Client Hints (JavaScript API)
APIサポート
loadingloading...
アーキテクチャ
loadingloading...
bitness
loadingloading...
ブランド (ブラウザブランド)
loadingloading...
完全バージョンリスト
loadingloading...
mobile
loadingloading...
model
loadingloading...
platform
loadingloading...
プラットフォームバージョン
loadingloading...
ユーザーエージェント完全バージョン
loadingloading...
WOW64 (64ビットWindows上の32ビット)
loadingloading...
リクエストヘッダー (User-Agent Client Hints)
sec-ch-ua
loadingloading...
sec-ch-ua-platform
loadingloading...
sec-ch-ua-mobile
loadingloading...
sec-ch-ua-full-version
loadingloading...
sec-ch-ua-platform-version
loadingloading...
sec-ch-ua-full-version-list
loadingloading...
sec-ch-ua-arch
loadingloading...
sec-ch-ua-bitness
loadingloading...
sec-ch-ua-wow64
loadingloading...
sec-ch-ua-model
loadingloading...
sec-ch-save-data
loadingloading...
sec-ch-width
loadingloading...
sec-ch-viewport-width
loadingloading...
viewport-width
loadingloading...
sec-ch-viewport-height
loadingloading...
sec-ch-dpr
loadingloading...
dpr
loadingloading...
sec-ch-device-memory
loadingloading...
device-memory
loadingloading...
sec-ch-rtt
loadingloading...
sec-ch-ect
loadingloading...
ect
loadingloading...
sec-ch-prefers-color-scheme
loadingloading...
sec-ch-prefers-reduced-motion
loadingloading...
sec-ch-prefers-reduced-transparency
loadingloading...
sec-ch-prefers-contrast
loadingloading...
sec-ch-forced-colors
loadingloading...
sec-ch-ua-form-factors
loadingloading...
既知のClient Hintsヘッダー(参考)
  • Sec-CH-UA
    ブラウザのブランド(複数可)とメジャーバージョンを表します。
  • Sec-CH-UA-Full-Version
    完全なブラウザバージョン文字列を示します。(廃止予定、Sec-CH-UA-Full-Version-Listに置き換えられました)
  • Sec-CH-UA-Full-Version-List
    完全なブラウザバージョン文字列を示します。
  • Sec-CH-UA-Platform
    ユーザーエージェントが実行されているプラットフォームを示します。
  • Sec-CH-UA-Platform-Version
    ユーザーエージェントが実行されているプラットフォームのバージョンを示します。
  • Sec-CH-UA-Arch
    ユーザーエージェントが実行されているプラットフォームのアーキテクチャを示します。
  • Sec-CH-UA-Bitness
    ユーザーエージェントが実行されているプラットフォームのアーキテクチャのビット数を示します。
  • Sec-CH-UA-WoW64
    ブラウザが64ビットWindowsで32ビットモードで実行されているかどうかを示します。
  • Sec-CH-UA-Model
    ユーザーエージェントが実行されているデバイスを示します。
  • Sec-CH-UA-Mobile
    ユーザーエージェントがモバイルエクスペリエンスを好むかどうかを示します。
  • Sec-CH-UA-Form-Factors
    デバイスのフォームファクターを示します。歴史的には、User-Agent文字列内のdeviceCompatトークンとして表現されていました。
  • Sec-CH-Lang
    (ユーザーの優先言語を表します。
  • Sec-CH-Save-Data
    (データ使用量を削減するためのユーザーエージェントの設定を表します。
  • Sec-CH-Width
    CSSピクセル単位で画像リソースリクエストのレイアウト幅を提供します。
  • Sec-CH-Viewport-Width
    (またはViewport-Width)は、ユーザーの表示ウィンドウの幅をCSSピクセルで示します。
  • Sec-CH-Viewport-Height
    ユーザーエージェントの表示ウィンドウの現在の高さを示します。
  • Sec-CH-DPR
    (またはDPR)は、ユーザーの画面の物理ピクセルとCSSピクセルの比率を示します。
  • Sec-CH-Device-Memory
    (またはDevice-Memory)は、現在のデバイスで利用可能なメモリの量を大まかに示します(GiB単位)。この情報はユーザーを特定するために使用される可能性があるため、Device-Memoryの値は意図的に粗く設定されています。有効な値は0.25、0.5、1、2、4、8です。
  • Sec-CH-RTT
    (またはRTT)は、アプリケーションレベルでの往復時間をおおよそ提供します(ミリ秒単位)。RTTはトランスポート層でのRTTとは異なり、サーバーの処理時間を含みます。RTTの値は、指紋認識を避けるために最も近い25ミリ秒の倍数に丸められます。
  • Sec-CH-Downlink
    (またはDownlink)は、ユーザーの接続の推定ダウンロード速度を示します(メガビット毎秒単位)。この値は、指紋認識を避けるために最も近い25キロビット毎秒の倍数に丸められます。
  • Sec-CH-ECT
    (またはECT)は、ブラウザによって推定された有効接続タイプを表します。その値は、RTTとダウンリンクの範囲内の値を説明する接続タイプの列挙の1つです。ECTの有効な値は4g、3g、2g、slow-2gです。
  • Sec-CH-Prefers-Color-Scheme
    ユーザーの好みのカラースキームを表します。
  • Sec-CH-Prefers-Reduced-Motion
    ユーザーがシステムによって使用されるアニメーションや動きの量を最小限に抑えることを要求しているかどうかを示します。
  • Sec-CH-Prefers-Reduced-Transparency
    ユーザーがシステムによって使用される透明または半透明のレイヤー効果の量を最小限に抑えることを要求しているかどうかを示します。
  • Sec-CH-Prefers-Contrast
    ユーザーがWebコンテンツをより高い(または低い)コントラストで表示することを要求しているかどうかを示します。
  • Sec-CH-Forced-Colors
    ユーザーエージェントが強制された色モードを有効にしているかどうかを示します。このモードでは、ユーザーが選択した制限されたカラーパレットをページ上で使用します。
Client Hints とは何で、User-Agent とどう違いますか?
Client Hints は sec-ch-ua で始まる HTTP リクエストヘッダーのセットと、対応する JS API で、ブラウザー、プラットフォーム、デバイスのフォームファクター情報を伝えるために使用されます。違いは、UA が毎回1つの長い文字列をダンプするのに対し、Client Hints はサーバーが必要に応じて要求し、構造化されたフィールドを持ち、粒度をはるかにうまく制御できることです。
一般的な Client Hints フィールドは何で、それぞれどういう意味ですか?
3つの低エントロピーヒントがデフォルトで送信されます。sec-ch-ua はブラウザーのブランドとメジャーバージョン、sec-ch-ua-platform は OS プラットフォーム、sec-ch-ua-mobile はモバイルデバイスかどうかです。高エントロピーフィールド(完全なバージョン、プラットフォームバージョン、アーキテクチャ、デバイスモデル)は、サーバーが明示的に要求するか、ページが navigator.userAgentData.getHighEntropyValues() を通じて取得する必要があります。
一部のサイトが他のサイトより多くの Client Hints データを取得するのはなぜですか?
高エントロピー値は要求されたときにのみ渡されるためです。サーバーは Accept-CH レスポンスヘッダーを使用して何が欲しいかを宣言する必要があり、その後に初めてブラウザーはそれらのフィールドを後続のリクエストに含めます。したがって、同じデバイスでも各サイトが何を要求したかによって、より詳細に見えたりそうでなかったりします。