Referenz zur Firefox User-Agent-Zeichenkette

Die UA-Zeichenkette von Firefox selbst ist in vier Komponenten unterteilt:

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

• Mozilla/5.0 ist das allgemeine Token, das anzeigt, dass der Browser mit Mozilla kompatibel ist, und ist heute bei fast jedem Browser üblich.
• platform beschreibt die native Plattform, auf der der Browser läuft (z.B. Windows, Mac, Linux oder Android), und ob es sich um ein Mobiltelefon handelt. Firefox OS-Telefone sagen Mobile; das Web ist die Plattform. Beachten Sie, dass platform aus mehreren durch ; getrennten Tokens bestehen kann. Siehe unten für weitere Details und Beispiele.
• rv:gecko-version zeigt die Veröffentlichungsversion von Gecko an (wie 17.0).
• Gecko/gecko-trail weist darauf hin, dass der Browser auf Gecko basiert.
• Auf Desktop ist gecko-trail die feste Zeichenkette 20100101.
• Firefox/firefox-version zeigt an, dass der Browser Firefox ist, und gibt die Version an (wie 17.0).
• Ab Firefox 10 auf Mobilgeräten ist gecko-trail dasselbe wie firefox-version.

Bei anderen auf Gecko basierenden Produkten kann die Zeichenkette eine von zwei Formen annehmen, wobei die Tokens die gleiche Bedeutung haben, außer denen, die unten aufgeführt sind:

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 gibt den Anwendungsnamen und die Version an. Zum Beispiel könnte dies Camino/2.1.1 oder SeaMonkey/2.7.1 sein.
• Firefox/firefox-version ist ein optionales Kompatibilitätstoken, das einige auf Gecko basierende Browser möglicherweise einbauen, um maximale Kompatibilität mit Websites zu erreichen, die Firefox erwarten. firefox-version wird im Allgemeinen die entsprechende Firefox-Version darstellen, die zu der angegebenen Gecko-Version gehört. Einige Gecko-basierte Browser entscheiden sich möglicherweise gegen die Verwendung dieses Tokens; aus diesem Grund sollten Sniffer nach Gecko suchen — nicht nach Firefox!

Der platform-Teil der UA-Zeichenkette zeigt an, ob Firefox auf einem Telefon oder Tablet läuft. Wenn Firefox auf einem Gerät im Telefonsformfaktor läuft, gibt es ein Mobile;-Token im platform-Teil der UA-Zeichenkette. Wenn Firefox auf einem Tablet läuft, gibt es stattdessen ein Tablet;-Token im platform-Teil der UA-Zeichenkette. Zum Beispiel:

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

Die bevorzugte Methode, um Inhalte auf einen Geräteformfaktor auszurichten, ist die Verwendung von CSS Media Queries. Wenn jedoch UA-Sniffing verwendet wird, um Inhalte auf einen Geräteformfaktor auszurichten, suchen Sie bitte nach Mobi (um auch Opera Mobile einzuschließen, das "Mobi" verwendet) für den Telefonsformfaktor und unterlassen Sie jegliche Annahme einer Korrelation zwischen "Android" und dem Geräteformfaktor. Auf diese Weise wird Ihr Code funktionieren, falls/wenn Firefox auf anderen Telefon-/Tablet-Betriebssystemen ausgeliefert wird oder Android für Laptops verwendet wird. Verwenden Sie außerdem Touch-Detektion, um Touch-Geräte zu finden, anstatt nach "Mobi" oder "Tablet" zu suchen, da es Touch-Geräte geben kann, die keine Tablets sind.

Windows-User-Agents haben folgende Variationen, wobei x.y die Windows NT-Version ist (zum Beispiel Windows NT 6.1).

Hierbei ist x.y die Version von macOS (zum Beispiel macOS 10.15). Beginnend mit Firefox 87 begrenzt Firefox die gemeldete macOS-Versionsnummer auf 10.15, sodass macOS 11.0 Big Sur und später als "10.15" in der User-Agent-Zeichenkette gemeldet werden. Macs mit ARM-basierten Prozessoren werden in der User-Agent-Zeichenkette als "Intel" gemeldet.

Linux ist eine vielfältigere Plattform. Ihre Linux-Distribution kann eine Erweiterung enthalten, die Ihren User-Agent ändert. Ein paar gängige Beispiele finden Sie unten.

Firefox für Android enthält die Android-Version als Teil des platform-Tokens. Für erhöhte Interoperabilität wird, wenn der Browser auf einer Version unter 4 läuft, 4.4 gemeldet. Android-Versionen ab 4 berichten die Version genau. Beachten Sie, dass dasselbe Gecko — mit denselben Fähigkeiten — für alle Android-Versionen ausgeliefert wird.

Ab Version 1 wird Focus von Android WebView betrieben und verwendet das folgende User-Agent-Zeichenkettenformat:

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>

Tablet-Versionen auf WebView spiegeln mobile Versionen wider, enthalten jedoch kein Mobile-Token.

Ab Version 6 können Benutzer sich für die Verwendung eines GeckoView-basierten Focus für Android mit einer versteckten Voreinstellung entscheiden: Es wird eine GeckoView-UA-Zeichenkette verwendet, um Gecko-Kompatibilität zu bewerben.

Der Klar-User-Agent ist derselbe wie Focus.

Firefox für iOS verwendet die Standard-Mobile-Safari-UA-Zeichenkette mit einem zusätzlichen FxiOS/<version> Token auf iPod und iPhone, ähnlich wie Chrome für iOS sich selbst identifiziert.

Auf dem iPad erscheint die User-Agent-Zeichenkette identisch wie Safari. Für verschiedene Probleme im Zusammenhang mit der Nichtaufnahme von FxiOS auf iOS siehe mozilla-mobile/firefox-ios#6620.

Version 7 von Focus für iOS verwendet eine User-Agent-Zeichenkette mit folgendem Format:

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

Hinweis: Dieser User-Agent wurde von einem iPhone XR-Simulator abgerufen und kann auf dem Gerät unterschiedlich sein.

Version 3 (und wahrscheinlich frühere) von Firefox für Fire TV verwenden eine User-Agent-Zeichenkette mit folgendem Format:

Mozilla/5.0 (Linux; <Android version>) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Focus/<firefox-version> Chrome/<Chrome Rev> Safari/<WebKit Rev>

Ab Version 1.1 verwendet Firefox für Echo Show eine User-Agent-Zeichenkette mit folgendem Format:

Mozilla/5.0 (Linux; <Android version>) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Focus/<firefox-version> Chrome/<Chrome Rev> Safari/<WebKit Rev>

Obwohl es von Mozilla stark entmutigt wird, fügen einige Gerätehersteller leider ein Token in die UA-Zeichenkette ihres Geräts ein, das ihre Geräte-ID darstellt. Wenn dies der Fall ist, sieht die UA-Zeichenkette von Firefox OS wie die gerätespezifische Zeichenkette in der obigen Tabelle aus, wobei nnnn; der Herstellercode für das Gerät ist (siehe Richtlinien). Einige bemerkte Formen sind "NexusOne;", "ZTEOpen;" oder "Open C;" (beachten Sie, dass auch das Setzen eines Leerzeichens entmutigt wird). Wir stellen diese Informationen zur Verfügung, um Ihre UA-Erkennungslogik zu unterstützen, aber Mozilla rät von der Erkennung einer Geräte-ID in UA-Zeichenketten ab.

Hier ist ein JavaScript-Regulärer Ausdruck, der alle mobilen Geräte erkennt, einschließlich Geräte mit einer Geräte-ID in ihrer UA-Zeichenkette:

/mobi/i;

Das i macht ihn groß-/klein-schreibungsempfindlich und mobi passt auf alle mobilen Browser.

Obwohl die Versionsnummer von Firefox OS nicht in der UA-Zeichenkette enthalten ist, ist es möglich, Versionsinformationen aus der Gecko-Versionsnummer in der UA-Zeichenkette abzuleiten.

Firefox OS hat eine vierstellige Versionsnummer: X.X.X.Y. Die ersten beiden Ziffern werden vom Mozilla-Produktionsteam verwaltet und kennzeichnen Versionen mit neuen Funktionen (z.B.: v1.1, 1.2, etc.). Die dritte Ziffer wird bei regulären Versionstags (etwa alle 6 Wochen) für Sicherheitsupdates erhöht, und die vierte wird vom OEM verwaltet.

• Empfehlungen zum Sniffen der UA-Zeichenkette für plattformübergreifende Unterstützung
• navigator.userAgent