В этом документе описана строка User-Agent, используемая в Firefox 4 и более поздних версиях, а также приложениях на основе Gecko 2.0 и более поздних версий. Описание изменений строки в Gecko 2.0 см. в статье Итоговая строка User-Agent для Firefox 4 (публикация в блоге). См. также документ о анализе строки User-Agent и эту публикацию в блоге Hacks.

Общий формат

Строка UA самого Firefox состоит из четырёх компонентов:

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/gecko-trail указывает, что браузер основан на Gecko.

• В настольной версии gecko-trail — это фиксированная строка 20100101.

• Firefox/firefox-version указывает, что браузер — Firefox, и содержит его версию (например, 17.0).

• Начиная с Firefox 10 для мобильных устройств, gecko-trail совпадает с firefox-version.

Для других продуктов на основе Gecko строка может иметь один из двух форматов; токены имеют тот же смысл, за исключением отмеченных ниже:

Mozilla/5.0 (platform; rv:gecko-version) Gecko/gecko-trail app-name/app-version Mozilla/5.0 (platform; rv:gecko-version) Gecko/gecko-trail Firefox/firefox-version app-name/app-version

• app-name/app-version указывает название и версию приложения. Например, это может быть Camino/2.1.1 или SeaMonkey/2.7.1.
• Firefox/firefox-version — это необязательный токен совместимости, который некоторые браузеры на основе Gecko могут включать для максимальной совместимости с веб-сайтами, рассчитанными на Firefox. firefox-version обычно соответствует версии Firefox, эквивалентной указанной версии Gecko. Некоторые браузеры на основе Gecko могут не использовать этот токен; поэтому при анализе строки следует искать Gecko, а не Firefox!

Признаки мобильных устройств и планшетов

Часть platform строки UA показывает, работает ли Firefox на устройстве размером с телефон или планшет. Когда Firefox работает на устройстве в форм-факторе телефона, в части platform строки UA присутствует токен Mobile;. Когда Firefox работает на планшете, вместо него в части platform строки UA присутствует токен Tablet;. Например:

Mozilla/5.0 (Android 4.4; Mobile; rv:41.0) Gecko/41.0 Firefox/41.0
Mozilla/5.0 (Android 4.4; Tablet; rv:41.0) Gecko/41.0 Firefox/41.0

Предпочтительный способ адаптировать содержимое к форм-фактору устройства — использовать медиазапросы CSS. Однако если для адаптации содержимого к форм-фактору устройства вы анализируете строку UA, ищите Mobi (чтобы учитывать Opera Mobile, в которой используется «Mobi») для форм-фактора телефона и не предполагайте какую-либо связь между «Android» и форм-фактором устройства. Так ваш код будет работать, если Firefox появится в других операционных системах для телефонов и планшетов или если Android будет использоваться на ноутбуках. Кроме того, для обнаружения устройств с сенсорным экраном используйте проверку поддержки сенсорного ввода, а не поиск «Mobi» или «Tablet», поскольку устройства с сенсорным экраном не всегда являются планшетами.

Windows

Строки User-Agent Windows имеют следующие варианты, где x.y — версия Windows NT (например, Windows NT 6.1).

macOS

Здесь x.y — версия macOS (например, macOS 10.15). Начиная с Firefox 87, Firefox ограничивает указываемый номер версии macOS значением 10.15, поэтому macOS 11.0 Big Sur и более поздние версии в строке User-Agent указываются как «10.15». Компьютеры Mac на базе ARM в строке User-Agent указываются как «Intel».

Linux

Linux — более разнообразная платформа. В вашем дистрибутиве Linux может быть расширение, изменяющее строку User-Agent. Ниже приведены несколько распространённых примеров.

Firefox для Android

Firefox для Android указывает версию Android в токене platform. Для повышения совместимости, если браузер работает на версии ниже 4, он будет указывать версию 4.4. Для Android 4 и более поздних версий указывается фактическая версия. Обратите внимание, что во всех версиях Android используется одна и та же версия Gecko с одинаковыми возможностями.

Focus для Android

Начиная с версии 1, Focus работает на Android WebView и использует следующий формат строки User-Agent:

Mozilla/5.0 (Linux; <Android Version> <Build Tag etc.>) AppleWebKit/<WebKit Rev> (KHTML, like Gecko) Version/4.0 Focus/<focus version> Chrome/<Chrome Rev> Mobile Safari/<WebKit Rev>

Версии для планшетов на WebView аналогичны мобильным, но не содержат токен Mobile.

Начиная с версии 6 пользователи могут включить Focus для Android на основе GeckoView с помощью скрытой настройки: он использует строку UA GeckoView, указывающую на совместимость с Gecko.

Строка User-Agent Klar совпадает со строкой Focus.

Firefox для iOS

Firefox для iOS использует стандартную строку UA Mobile Safari, добавляя токен FxiOS/<version> на iPod и iPhone, подобно тому, как Chrome для iOS указывает свою идентичность.

На iPad строка User-Agent выглядит так же, как в Safari. Сведения о различных проблемах, связанных с отсутствием FxiOS в iOS, см. в mozilla-mobile/firefox-ios#6620.

Focus для iOS

В версии 7 Focus для iOS используется строка User-Agent следующего формата:

Mozilla/5.0 (iPhone; CPU iPhone OS 12_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/7.0.4 Mobile/16B91 Safari/605.1.15

Примечание: эта строка User-Agent получена в симуляторе iPhone XR и может отличаться на устройстве.

См. также

• Рекомендации по анализу строки UA для поддержки разных браузеров
• navigator.userAgent