User-Agent
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
User-Agent リクエストヘッダーは、サーバーやネットワークピアがアプリケーション、オペレーティングシステム、ベンダーや、リクエストしているユーザーエージェントのバージョン等を識別できるようにする特性文字列です。
警告: ブラウザーによって異なるウェブページやサービスを提供することが、通常は悪い考えである理由については、ユーザーエージェント文字列を用いたブラウザーの判定をお読みください。
構文
User-Agent: <product> / <product-version> <comment>
ウェブブラウザーでよくある書式は以下のようなものです。
User-Agent: Mozilla/5.0 (<system-information>) <platform> (<platform-details>) <extensions>
ディレクティブ
<product>
-
製品の識別子です。名前または開発コードネームです。
<product-version>
-
製品のバージョン番号です。
<comment>
-
ゼロ個以上のコメントで、サブ製品情報など、より詳細な情報を含みます。
Firefox の UA 文字列
Firefox や Gecko ベースのユーザーエージェント文字列の詳細については、 Firefox のユーザーエージェント文字列リファレンスを参照してください。 Firefox の UA 文字列は 4 つの部分に分解されます。
Mozilla/5.0 (platform; rv:gecko-version) Gecko/gecko-trail Firefox/firefox-version
Mozilla/5.0
は、 Mozilla と互換性があるブラウザーであるということを示す一般的なトークンで、現在はほぼすべてのブラウザーで共通です。- platform は、ブラウザーが動作しているプラットフォーム (Windows, Mac, Linux, Android など)、およびモバイル端末かどうかを示します。 Firefox OS のスマートフォンはウェブプラットフォームなので、
Mobile
だけです。 platform が複数の;
で区切られていることに留意してください。後述の詳細と例も併せてご覧ください。 - rv:gecko-version は Gecko のリリースバージョンです ("17.0" など)。最近のブラウザーの gecko-version は firefox-version と同じです。
- Gecko/gecko-trail は、ブラウザーが Gecko を基にしていることを示します。 (デスクトップでは、 gecko-trail は常に
20100101
の固定文字列です。) - Firefox/firefox-version は、ブラウザーが Firefox であること、またそのバージョン ("17.0" など) を示しています。
例
Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0 Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:42.0) Gecko/20100101 Firefox/42.0
Chrome の UA 文字列
Chrome (または Chromium/Blink ベースのエンジン) のユーザーエージェント文字列は Firefox のものと似ています。互換性のため、 KHTML, like Gecko
や Safari
のような文字列が追加されています。
例
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.103 Safari/537.36
Opera の UA 文字列
Opera ブラウザーも Blink エンジンに基づいているので、大部分は同じですが、 "OPR/<version>"
を追加します。
例
Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/51.0.2704.106 Safari/537.36 OPR/38.0.2220.41
古い Presto ベースの Opera のリリースは、次のものを使用していました。
Opera/9.80 (Macintosh; Intel Mac OS X; U; en) Presto/2.2.15 Version/10.00 Opera/9.60 (Windows NT 6.0; U; en) Presto/2.1.1
Microsoft Edge の UA 文字れ鵜t
Edge ブラウザーも Blink エンジンをベースとしています。 "Edg/<version>"
を追加します。
例
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36 Edg/91.0.864.59
Safari の UA 文字列
この例では、ユーザーエージェント文字列はモバイル Safari のものです。これは "Mobile"
という語を含んでいます。
例
Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Mobile/15E148 Safari/604.1
クローラーやボットの UA 文字列
例
Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)
Mozilla/5.0 (compatible; YandexAccessibilityBot/3.0; +http://yandex.com/bots)
ライブラリーやネットツールの UA 文字列
例
curl/7.64.1
PostmanRuntime/7.26.5
仕様書
Specification |
---|
HTTP Semantics # field.user-agent |
ブラウザーの互換性
BCD tables only load in the browser