ブログに戻る

User-AgentとClient Hintsとは:ブラウザー情報・プライバシー・互換性の確認

サイトはUser-Agentヘッダー、JavaScript、Client Hintsから情報を得られます。それぞれの違い、初期情報と要求する情報、UA変更だけでは環境全体が変わらない理由、自社サイトでの調査を説明します。

User-Agentはサイトにブラウザーを説明しますが、端末の身分証ではありません。現在のサイトはスクリプト、Client Hints、実行条件も参照できます。UA文字列を変えてもOS、機能、すべての信号が変わるわけではありません。

開発者は実際の機能に基づいて提供し、利用者と運用チームは公開される情報と推論の限界を理解する必要があります。

UA文字列が誤解されやすい理由

User-Agentヘッダーには通常ブラウザーとプラットフォームの記号があり、スクリプトは navigator.userAgent を読めます。過去との互換性で複数の製品名が含まれても、それぞれ別の使用中ブラウザーを示しません。

UAは削減、変更、中間処理での書き換えもあり得ます。一語だけで機能を判断すると、対応ブラウザーを誤って排除します。

ファイルアップロードなら名前より関連機能と挙動を検出します。UAは限定的な手掛かりで、機能検出の代わりではありません。

Client Hintsが変えるもの

ChromeのUser-Agent Client Hintsの説明は構造化された情報要求を紹介します。長い文字列の解析ではなく必要な項目を求めますが、何を渡すかはブラウザーの方針で決まります。

インターフェースと伝達方法を区別してください。

情報源位置確認点
User-AgentHTTP要求ヘッダーその要求で実際に送った値
navigator.userAgentページのJavaScriptそのスクリプトが読んだ文字列
Sec-CH-UAなど対応ブラウザーの要求ヘッダー送信有無、意味、要求条件
navigator.userAgentData対応スクリプト環境有無と取得可能な項目

ヘッダーとスクリプトは観測地点が違います。CDN、プロキシ、キャッシュ、ログも別の処理層かもしれません。取得元を明確にして比較します。

低・高エントロピーは信頼性の区別ではない

エントロピーは区別の手掛かりとなる情報量で、正確さの保証やアカウント危険度ではありません。

MDNのNavigatorUAData資料は基本属性と非同期で求める追加情報を区別し、互換性確認を促します。項目が多くても完全・正確・変更不能な端末一覧が常に届くわけではありません。

自社サイトでは項目の必要性を問います。レイアウトはレスポンシブ、機能は能力検出を優先し、APIがあるからと全情報を集めないでください。

自分のブラウザーで基本情報を見る

以下はローカルの基本情報だけを読み、外部送信しません。管理するテストページか開発者ツールで実行できます。

const browserInfo = {
  userAgent: navigator.userAgent,
  hints: navigator.userAgentData?.toJSON() ?? null,
};

console.log(browserInfo);

hints が null なら、異常と決める前に対応と実行条件を確認します。ブラウザー、版、文脈で結果が異なるため、適切な代替動作が必要です。

ヘッダーはネットワークパネルで特定の要求を選びます。別要求、別タブ、古いキャッシュ記録とスクリプト結果を混同しないでください。

追加情報の要求では経路全体を見る

サーバーは Accept-CH などを使えますが、受信の有無、どの要求か、許可されるかは実通信で検証します。HTTPS、対応、方針で結果が変わります。

応答で期待する要求が出ているか、次の通信に項目があるかを確認します。CDNやキャッシュでは変種の区別も調べ、別条件向けの応答が渡らないようにします。

最初の要求で項目がなくても「偽装失敗」とはいえません。通常の対応範囲や交渉の結果かもしれません。

UAだけ変えても環境全体が変わらない理由

UAは一部です。言語、時刻帯、ウィンドウ、描画、フォント、拡張、サイトデータは別の仕組みで作用します。一設定で全層は変わりません。

携帯名を書いてもPCが同じタッチ機能、配置、ハードウェアを持ちません。それだけで携帯用ボタンを表示すれば互換性問題を招くことがあります。

ランダムな変更より業務に必要な安定設定と追跡できる記録を保ちます。規約、ログイン安全、許可された操作は別途管理が必要です。

チームで「同じアカウント、違うページ」を調べる

環境、版、URL、時刻、問題の機能を記録し、必要最小限の情報を集めます。正常と異常の比較では一条件ずつ変えます。

PurpleMarkではOS、エンジン、User-Agent、言語、時刻帯を確認して対象環境でテストを開けます。顧客・用途別のグループ化で実務との対応も容易です。

検査サイトの点数だけで安全や制限を断定しないでください。観測するのは自身の試験信号であり、対象サイト全体の動作や内部判断ではありません。

Web開発者向け確認項目

  • 重要機能は能力検出し、UAは必要で範囲を限定した互換性処理に使う。
  • Client Hints非対応でも代替動作を用意し、作業不能な空白ページにしない。
  • ヘッダー、スクリプト、中間処理後のログを区別する。
  • 業務に必要な情報だけ求め、実際のプライバシー説明に従う。
  • 更新後は同じページと入力で再確認し、全差分を指紋のせいにしない。

理解の目的は誤った推測を減らすことです。条件と互換性の境界を持つ信号を実際の業務に即して解釈すると、互換性とプライバシー管理を改善できます。