Firefox User-Agent-String-Referenz

Der UA-String 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 besagt, 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 oder nicht. Firefox OS-Telefone geben Mobile an; 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 gibt die Versionsnummer des Gecko-Releases an (zum Beispiel 17.0).

• Gecko/gecko-trail zeigt an, dass der Browser auf Gecko basiert.

• Auf Desktops ist gecko-trail die feste Zeichenfolge 20100101.

• Firefox/firefox-version gibt an, dass der Browser Firefox ist und bietet die Version an (zum Beispiel 17.0).

• Ab Firefox 10 auf mobilen Geräten ist gecko-trail identisch mit firefox-version.

Für andere auf Gecko basierende Produkte kann der String eine von zwei Formen annehmen, wobei die Tokens die gleiche Bedeutung haben, außer den unten angegebenen:

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

• appname/appversion gibt den Anwendungsnamen und die Version an. Dies könnte zum Beispiel Camino/2.1.1 oder SeaMonkey/2.7.1 sein.
• Firefox/firefox-version ist ein optionales Kompatibilitätstoken, das einige Gecko-basierte Browser eventuell integrieren, um maximale Kompatibilität mit Websites zu erreichen, die Firefox erwarten. firefox-version wird im Allgemeinen die entsprechende Firefox-Version für die angegebene Gecko-Version darstellen. Einige Gecko-basierte Browser verzichten möglicherweise auf die Verwendung dieses Tokens; aus diesem Grund sollten Sniffer nach Gecko — nicht nach Firefox — suchen!

Der platform-Teil des UA-Strings gibt an, ob Firefox auf einem Gerät in Telefon- oder Tablet-Größe läuft. Wenn Firefox auf einem Gerät läuft, das die Telefonform hat, gibt es ein Mobile;-Token im platform-Teil des UA-Strings. Wenn Firefox auf einem Tablet-Gerät läuft, gibt es stattdessen ein Tablet;-Token im platform-Teil des UA-Strings. 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

Der bevorzugte Weg, um Inhalte auf eine Geräteform abzustimmen, ist die Verwendung von CSS Media Queries. Wenn Sie jedoch UA-Sniffing verwenden, um Inhalte auf eine Geräteform abzustimmen, suchen Sie bitte nach Mobi (um Opera Mobile einzuschließen, das "Mobi" verwendet) für die Telefonform und nehmen Sie keine Korrelation zwischen "Android" und der Geräteform an. Auf diese Weise wird Ihr Code funktionieren, wenn/als Firefox auf anderen Telefon-/Tablet-Betriebssystemen veröffentlicht wird oder Android auf Laptops verwendet wird. Bitte verwenden Sie auch Touch-Erkennung, um Touch-Geräte zu finden, anstatt nach "Mobi" oder "Tablet" zu suchen, da es möglicherweise Touch-Geräte gibt, die keine Tablets sind.

Windows User Agents haben die folgenden 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). Ab Firefox 87 begrenzt Firefox die gemeldete macOS-Version auf 10.15, sodass macOS 11.0 Big Sur und spätere Versionen in der User-Agent-String als "10.15" gemeldet werden. ARM-basierte Macs werden im User-Agent-String als "Intel" gemeldet.

Linux ist eine vielfältigere Plattform. Ihre Linux-Distribution könnte eine Erweiterung enthalten, die Ihren User-Agent ändert. Einige häufige Beispiele werden unten angegeben.

Firefox für Android enthält die Android-Version als Teil des platform-Tokens. Für eine höhere Interoperabilität wird, wenn der Browser auf einer Version unter 4 läuft, 4.4 gemeldet. Android-Versionen ab 4 und höher melden die Version korrekt. Beachten Sie, dass das gleiche Gecko — mit den gleichen Fähigkeiten — für alle Android-Versionen geliefert wird.

Ab Version 1 basiert Focus auf Android WebView und verwendet das folgende User-Agent-String-Format:

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 Geräte wider, enthalten jedoch kein Mobile-Token.

Ab Version 6 können Nutzer sich für die Verwendung einer GeckoView-basierten Focus für Android mit einer versteckten Einstellung entscheiden: Es verwendet einen GeckoView-UA-String, um Gecko-Kompatibilität zu bewerben.

Der Klar-User-Agent ist derselbe wie Focus.

Firefox für iOS verwendet den standardmäßigen Mobile Safari UA-String mit einem zusätzlichen FxiOS/<version>-Token auf iPod und iPhone, ähnlich wie Chrome für iOS sich identifiziert.

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

Version 7 von Focus für iOS verwendet einen User-Agent-String mit dem folgenden 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 könnte auf einem echten Gerät anders sein.

Version 3 (und vermutlich frühere) von Firefox für Fire TV verwenden einen User-Agent-String mit dem folgenden 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 einen User-Agent-String mit dem folgenden 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 strengstens untersagt ist, fügen einige Gerätehersteller leider ein Token in den UA-String ihres Geräts ein, das ihre Geräte-ID darstellt. Falls dies der Fall ist, sieht der Firefox OS-UA-String wie der gerätespezifische String in der obigen Tabelle aus, wobei nnnn; der Herstellercode für das Gerät ist (siehe Richtlinien). Einige, die wir bemerkt haben, sind von der Form "NexusOne;", "ZTEOpen;" oder "Open C;" (beachten Sie, dass das Einfügen von Leerzeichen ebenfalls nicht empfohlen wird). Wir stellen diese Informationen bereit, um Ihnen bei Ihrer UA-Erkennungslogik zu helfen, jedoch rät Mozilla von der Erkennung einer Geräte-ID in UA-Strings ab.

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

/mobi/i;

Das i macht es nicht unterscheidend zwischen Groß- und Kleinschreibung und mobi passt zu allen mobilen Browsern.

Während die Versionsnummer für Firefox OS nicht im UA-String enthalten ist, ist es möglich, Versionsinformationen aus der Gecko-Versionsnummer im UA-String abzuleiten.

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

• Empfehlungen zum Sniffing des UA-Strings für Browser-übergreifende Unterstützung
• navigator.userAgent