User-Agent: Firefox
本文档描述了 Firefox 4 及更高版本中使用的用户代理字符串以及基于 Gecko 2.0 和更高版本的应用程序。有关 Gecko 2.0 中字符串更改的详细信息，请参阅 Firefox 4的最终用户代理字符串（博客文章）。关于用户代理嗅探和这个 Hacks博客文章，另请参阅此文档。
一般形式
Firefox 本身的 UA 字符串被分解为四个组件：
Mozilla / 5.0（platform ; rv：geckoversion）Gecko / geckotrail Firefox / firefoxversion
- Mozilla / 5.0 是一款表示浏览器兼容 Mozilla 的通用标记，并且几乎适用于今天的所有浏览器。
- 平台描述浏览器运行的本地平台（例如Windows，Mac，Linux 或 Android）以及它是否是手机。Firefox OS 手机只是说“手机”; 网络就是平台。请注意，平台可以由多个“;”分隔的令牌组成。请参阅下面的进一步细节和示例。
- rv：geckoversion 表示 Gecko 的发布版本（例如“17.0”）。在最近的浏览器中，geckoversion 与 firefoxversion 相同。
- Gecko / geckotrail 表明浏览器基于 Gecko。
- 在桌面上，geckotrail 是固定字符串“20100101”
- Firefox / firefoxversion 表示浏览器是 Firefox，并提供版本（例如“ 17.0”）。
- 从手机上的 Firefox 10开始，geckotrail 和 firefoxversion 一样
对于基于 Gecko 的浏览器（如果您必须嗅探浏览器引擎而不是使用功能检测），推荐使用 “ Gecko ” 和 “ rv： ”字符串，因为其他浏览器包含 “ like Gecko “ 令牌。
对于其他基于 Gecko 的产品，字符串可以采用两种形式之一，其中令牌具有相同的含义，但下面提到的除外：
Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail appname/appversion
Mozilla / 5.0（platform ; rv：geckoversion）Gecko / geckotrail Firefox / firefoxversion appname / appversion
- appname / appversion 指示应用程序名称和版本。例如，这可以是 “ Camino / 2.1.1 ”或“ SeaMonkey / 2.7.1 ”。
- Firefox / firefoxversion 是一个可选的兼容性令牌，一些基于 Gecko 的浏览器可能会选择合并，以实现与期望Firefox的网站的最大兼容性。firefoxversion 通常会代表与给定的 Gecko 版本相对应的等效 Firefox 版本。一些基于 Gecko 的浏览器可能不会使用此令牌; 出于这个原因，嗅探器应该寻找壁虎 - 而不是 Firefox！此标记是否显示由 “general.useragent.compatMode.firefox” 布尔值前缀控制。
移动和平板电脑指标
需要 Gecko 11.0（Firefox 11.0 / Thunderbird 11.0 / SeaMonkey 2.8）
UA 字符串的平台部分指示 Firefox 是否在手机尺寸或平板电脑设备上运行。当 Firefox 在具有手机外形的设备上运行时，会出现 Mobile; 令牌在 UA 字符串的平台部分。当 Firefox 在平板电脑设备上运行时，有一款平板电脑; 代替UA字符串的平台部分中的令牌。例如：
Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0Mozilla/5.0 (Android 4.4; Tablet; rv:41.0) Gecko/41.0 Firefox/41.0
版本号不相关。避免基于这些推断材料。
将内容定位到设备外形的首选方式是使用 CSS Media Queries。但是，如果您使用 UA 嗅探到目标内容到设备的外形尺寸，请认准摩比（包括Opera移动，它采用“牧高笛”）手机的外形和你没有承担的 “Android” 和设备之间的任何关联构成因素。这样，如果/当 Firefox 在其他手机/平板电脑操作系统上发布或 Android 用于笔记本电脑时，您的代码将可以正常工作。此外，请使用触摸检测来寻找触摸设备，而不是寻找“手机”或“平板电脑”，因为可能有触摸设备不是平板电脑。
Firefox OS 设备在没有任何操作系统指示的情况下自行识别; 例如： “Mozilla / 5.0（Mobile; rv：15.0）Gecko / 15.0 Firefox / 15.0”。网络是平台。
Windows
Windows 用户代理具有以下变体，其中 xy 是 Windows NT 版本（例如 Windows NT 6.1）。
Windows version | Gecko user agent string |
|---|---|
Windows NT on x86 | Mozilla/5.0 (Windows NT x.y; rv:10.0) Gecko/20100101 Firefox/10.0 |
Windows NT, Win64 on x64 | Mozilla/5.0 (Windows NT x.y; Win64; x64; rv:10.0) Gecko/20100101 Firefox/10.0 |
Windows NT, WOW64 | Mozilla/5.0 (Windows NT x.y; WOW64; rv:10.0) Gecko/20100101 Firefox/10.0 |
Macintosh
这里，xy 是 Mac OS X 的版本（例如，Mac OS X 10.6）。
Mac OS X version | Gecko user agent string |
|---|---|
Mac OS X on Intel x86 or x86_64 | Mozilla/5.0 (Macintosh; Intel Mac OS X x.y; rv:10.0) Gecko/20100101 Firefox/10.0 |
Mac OS X on PowerPC | Mozilla/5.0 (Macintosh; PPC Mac OS X x.y; rv:10.0) Gecko/20100101 Firefox/10.0 |
Linux
Linux 是一个更多元化的平台。下面给出几个常见的例子。
Linux version | Gecko user agent string |
|---|---|
Linux desktop, i686 | Mozilla/5.0 (X11; Linux i686; rv:10.0) Gecko/20100101 Firefox/10.0 |
Linux desktop, x86_64 | Mozilla/5.0 (X11; Linux x86_64; rv:10.0) Gecko/20100101 Firefox/10.0 |
Linux desktop, i686 running on x86_64 | Mozilla/5.0 (X11; Linux i686 on x86_64; rv:10.0) Gecko/20100101 Firefox/10.0 |
Nokia N900 Linux mobile, on the Fennec browser | Mozilla/5.0 (Maemo; Linux armv7l; rv:10.0) Gecko/20100101 Firefox/10.0 Fennec/10.0 |
Android（版本40及以下）
Form factor | Gecko user agent string |
|---|---|
Phone | Mozilla/5.0 (Android; Mobile; rv:40.0) Gecko/40.0 Firefox/40.0 |
Tablet | Mozilla/5.0 (Android; Tablet; rv:40.0) Gecko/40.0 Firefox/40.0 |
Android（版本41及以上）
从版本41开始，适用于 Android 的 Firefox 将包含 Android 版本作为平台令牌的一部分。为了提高互操作性，如果浏览器运行在低于4的版本上，它将报告4.4。Android 版本4及以上将准确报告版本。请注意，相同的 Gecko 具有相同的功能，可以运送到所有版本的 Android。
Form factor | Gecko user agent string |
|---|---|
Phone | Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0 |
Tablet | Mozilla/5.0 (Android 4.4; Tablet; rv:41.0) Gecko/41.0 Firefox/41.0 |
Firefox OS
Form factor | Gecko user agent string |
|---|---|
Phone | Mozilla/5.0 (Mobile; rv:26.0) Gecko/26.0 Firefox/26.0 |
Tablet | Mozilla/5.0 (Tablet; rv:26.0) Gecko/26.0 Firefox/26.0 |
TV | Mozilla/5.0 (TV; rv:44.0) Gecko/44.0 Firefox/44.0 |
Device-specific | Mozilla/5.0 (Mobile; nnnn; rv:26.0) Gecko/26.0 Firefox/26.0 |
设备特定的用户代理字符串
尽管 Mozilla 非常消极，但一些手机制造商不幸在其设备的 UA 字符串中包含代表其设备 ID 的令牌。如果是这种情况，则 Firefox OS UA 字符串将看起来像上表中的设备特定字符串，其中 nnnn ; 是设备的制造商代码（请参阅指南）。其中一些我们注意到的形式是 “ NexusOne ”，“ ZTEOpen ”或“ Open C; ”（注意放置空间也是不鼓励的）。我们提供此信息以协助您的 UA 检测逻辑，但 Mozilla 不鼓励检测 UA 字符串中的设备 ID。
这是一个 JavaScript 正则表达式，它将检测所有移动设备，包括设备 ID 在其 UA 字符串中的设备：
/mobi/i
这使其不区分i大小写，mobi匹配所有移动浏览器。
Firefox OS 版本号
虽然 Firefox OS 的版本号未包含在 UA 字符串中，但可以根据 UA 字符串中存在的 Gecko 版本号推断版本信息。
Firefox OS version number | Gecko version number |
|---|---|
1.0.1 | 18.0 |
1.1 | 18.1 |
1.2 | 26.0 |
1.3 | 28.0 |
1.4 | 30.0 |
2.0 | 32.0 |
2.1 | 34.0 |
2.2 | 37 |
2.5 | 44 |
通过查看 Mercurial 存储库名称很容易找到对应关系：从mozilla-b2gFirefox 开始的版本库是 Firefox OS 的版本库，并且 Firefox OS和Gecko 版本都以它们的名字命名。
Firefox OS 具有四位数版本号：XXXY 前两位数字由 Mozilla 产品团队拥有，并表示具有新功能（例如 v1.1,1.2等）的版本。第三位数字随着常规版本标签（大约每6周）增加一次安全更新，第四位数字由 OEM 拥有。
适用于 iOS 的 Firefox
适用于 iOS 的 Firefox 使用默认 Mobile Safari UA 字符串，并具有附加的 FxiOS / <版本>标记，这与 Chrome for iOS标识自身的方式类似。
Form factor | Firefox for iOS user agent string |
|---|---|
iPod | Mozilla/5.0 (iPod touch; CPU iPhone OS 8_3 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) FxiOS/1.0 Mobile/12F69 Safari/600.1.4 |
iPhone | Mozilla/5.0 (iPhone; CPU iPhone OS 8_3 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) FxiOS/1.0 Mobile/12F69 Safari/600.1.4 |
iPad | Mozilla/5.0 (iPad; CPU iPhone OS 8_3 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) FxiOS/1.0 Mobile/12F69 Safari/600.1.4 |
Firefox Web Runtime
Web Runtime 使用与桌面版 Firefox 相同的用户代理字符串。
其他基于 Gecko 的浏览器
这些是来自不同平台上其他基于 Gecko 的浏览器的一些示例UA字符串。请注意，其中很多尚未在 Gecko 2.0 上发布！
Browser | Gecko user agent string |
|---|---|
Firefox for Maemo (Nokia N900) | Mozilla/5.0 (Maemo; Linux armv7l; rv:10.0.1) Gecko/20100101 Firefox/10.0.1 Fennec/10.0.1 |
Camino on Mac | Mozilla/5.0 (Macintosh; Intel Mac OS X 10.5; rv:2.0.1) Gecko/20100101 Firefox/4.0.1 Camino/2.2.1 |
SeaMonkey on Windows | Mozilla/5.0 (Windows NT 5.2; rv:10.0.1) Gecko/20100101 Firefox/10.0.1 SeaMonkey/2.7.1 |
SeaMonkey on Mac | Mozilla/5.0 (Macintosh; Intel Mac OS X 10.5; rv:10.0.1) Gecko/20100101 Firefox/10.0.1 SeaMonkey/2.7.1 |
SeaMonkey on Linux | Mozilla/5.0 (X11; Linux i686; rv:10.0.1) Gecko/20100101 Firefox/10.0.1 SeaMonkey/2.7.1 |
应用程序，供应商和扩展的实施说明
在 Firefox 4 和 Gecko 2.0 之前，扩展可以通过general.useragent.extra.identifier首选项添加用户代理部分，（参见过时的用户代理字符串参考）。但是自从 bug 581008 以来，这是不可能的。
从前，特定插件，插件或扩展程序添加了用户代理部件以通知其安装的站点。推荐的做法是，如果它是绝对必要的（记住它会减慢每个请求的速度）是设置一个自定义 HTTP 头。