Référence de la chaîne de caractères d'agent utilisateur de Firefox

Forme générale

La chaîne de caractères d'agent utilisateur de Firefox elle-même se décompose en quatre composants :

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

• Mozilla/5.0 est le jeton général qui indique que le navigateur est compatible avec Mozilla, et il est commun à presque tous les navigateurs aujourd'hui.
• platform décrit la plateforme native sur laquelle le navigateur s'exécute (par exemple, Windows, Mac, Linux ou Android), et si c'est un téléphone mobile ou non. Les téléphones Firefox OS indiquent Mobile ; le web est la plateforme. Notez que platform peut se composer de plusieurs jetons séparés par des ;. Voir ci-dessous pour plus de détails et d'exemples.

• rv:gecko-version indique la version de publication de Gecko (par exemple 17.0).
• Gecko/gecko-trail indique que le navigateur est basé sur Gecko.
• Sur ordinateur, gecko-trail est la chaîne de caractères fixe 20100101.
• Firefox/firefox-version indique que le navigateur est Firefox, et fournit la version (par exemple 17.0).
• À partir de Firefox 10 sur mobile, gecko-trail est identique à firefox-version.

Pour d'autres produits basés sur Gecko, la chaîne de caractères peut prendre l'une des deux formes, les jetons ayant la même signification sauf indication contraire ci-dessous :

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 indique le nom et la version de l'application. Par exemple, cela peut être Camino/2.1.1, ou SeaMonkey/2.7.1.
• Firefox/firefox-version est un jeton de compatibilité optionnel que certains navigateurs basés sur Gecko peuvent choisir d'incorporer, afin d'obtenir une compatibilité maximale avec les sites Web qui s'attendent à Firefox. firefox-version représente généralement la version équivalente de Firefox correspondant à la version de Gecko donnée. Certains navigateurs basés sur Gecko peuvent ne pas choisir d'utiliser ce jeton ; pour cette raison, les détecteurs doivent rechercher Gecko — et non Firefox !

Indicateurs pour mobile et tablette

La partie platform de la chaîne de caractères de l'agent utilisateur indique si Firefox s'exécute sur un appareil de taille téléphone ou tablette. Lorsque Firefox s'exécute sur un appareil ayant le facteur de forme téléphone, il y a un jeton Mobile; dans la partie platform de la chaîne de caractères de l'agent utilisateur. Lorsque Firefox s'exécute sur un appareil tablette, il y a à la place un jeton Tablet; dans la partie platform de la chaîne de caractères de l'agent utilisateur. Par exemple :

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

La manière recommandée de cibler le contenu en fonction du facteur de forme d'un appareil est d'utiliser les requêtes média CSS. Cependant, si vous utilisez la détection de l'agent utilisateur pour cibler le contenu en fonction du facteur de forme d'un appareil, veuillez rechercher Mobi (pour inclure Opera Mobile, qui utilise « Mobi ») pour le facteur de forme téléphone et ne pas supposer de corrélation entre « Android » et le facteur de forme de l'appareil. De cette manière, votre code fonctionne si/lorsque Firefox est disponible sur d'autres systèmes d'exploitation pour téléphones/tablettes ou si Android est utilisé pour les ordinateurs portables. De plus, veuillez utiliser la détection tactile pour trouver les appareils tactiles plutôt que de rechercher « Mobi » ou « Tablet », car il peut y avoir des appareils tactiles qui ne sont pas des tablettes.

Windows

Les agents utilisateurs de Windows présentent les variantes suivantes, où x.y correspond à la version de Windows NT (par exemple, Windows NT 6.1).

macOS

Ici, x.y correspond à la version de macOS (par exemple, macOS 10.15). À partir de Firefox 87, Firefox limite le numéro de version de macOS signalé à 10.15, si bien que macOS 11.0 Big Sur et les versions ultérieures sont signalés comme « 10.15 » dans la chaîne de caractères d'agent utilisateur. Les Mac à processeur ARM sont signalés comme « Intel » dans la chaîne de caractères d'agent utilisateur.

Linux

Linux est une plateforme plus diversifiée. Votre distribution Linux peut inclure une extension qui modifie votre agent utilisateur. Quelques exemples courants figurent ci-dessous.

Firefox pour Android

Firefox pour Android inclut la version d'Android dans le jeton platform. Pour améliorer l'interopérabilité, lorsque le navigateur s'exécute sur une version antérieure à 4, il signale la version 4.4. Les versions 4 et ultérieures d'Android signalent leur numéro de version exact. Notez que la même version de Gecko, avec les mêmes fonctionnalités, est fournie pour toutes les versions d'Android.

Focus pour Android

Depuis la version 1, Focus repose sur Android WebView et utilise le format de chaîne de caractères d'agent utilisateur suivant :

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>

Les versions pour tablette sur WebView reprennent les versions mobiles, mais ne contiennent pas le jeton Mobile.

À partir de la version 6, vous pouvez choisir d'utiliser une version de Focus pour Android basée sur GeckoView au moyen d'une préférence masquée : elle utilise une chaîne de caractères d'agent utilisateur GeckoView pour annoncer sa compatibilité avec Gecko.

L'agent utilisateur de Klar est identique à celui de Focus.

Firefox pour iOS

Firefox pour iOS utilise la chaîne de caractères d'agent utilisateur Mobile Safari par défaut, avec un jeton FxiOS/<version> supplémentaire sur iPod et iPhone, comme Chrome pour iOS s'identifie ^(angl.).

Sur iPad, la chaîne de caractères d'agent utilisateur apparaît comme celle de Safari. Pour différents problèmes liés à l'absence de FxiOS sur iOS, consultez mozilla-mobile/firefox-ios#6620 ^(angl.).

Focus pour iOS

La version 7 de Focus pour iOS utilise une chaîne de caractères d'agent utilisateur au format suivant :

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

Note : cet agent utilisateur provient d'un simulateur d'iPhone XR et peut différer sur l'appareil.

Voir aussi

• Recommandations pour détecter la chaîne de caractères d'agent utilisateur afin d'assurer la compatibilité entre navigateurs
• La propriété API navigator.userAgent