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 heute in fast jedem Browser üblich ist.

• 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 zeigt die Release-Version von Gecko an (z. B. 17.0).

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

• Auf dem Desktop ist gecko-trail die feste Zeichenfolge 20100101.

• Firefox/firefox-version gibt an, dass der Browser Firefox ist, und enthält die Version (z. B. 17.0).

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

Für andere Produkte, die auf Gecko basieren, kann die Zeichenfolge eine von zwei Formen annehmen, wobei die Tokens dieselbe Bedeutung haben, außer den unten aufgeführten:

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. 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 Gecko-basierte Browser möglicherweise einfügen, um maximale Kompatibilität mit Websites zu erreichen, die Firefox erwarten. firefox-version wird im Allgemeinen die entsprechende Firefox-Version darstellen, die der angegebenen Gecko-Version entspricht. Einige Gecko-basierte Browser können sich dagegen entscheiden, dieses Token zu verwenden; aus diesem Grund sollten Schnüffler nach Gecko und nicht nach Firefox suchen!

Der platform-Teil des UA-Strings gibt an, ob Firefox auf einem telefon- oder tabletgroßen Gerät läuft. Wenn Firefox auf einem Gerät läuft, das die Form eines Telefons 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, Inhalte für ein Geräteformat zu erstellen, ist die Verwendung von CSS Media Queries. Wenn Sie jedoch UA-Sniffing verwenden, um Inhalte auf ein Geräteformat abzustimmen, suchen Sie bitte nach Mobi (um Opera Mobile einzuschließen, das "Mobi" verwendet) für das Telefon-Format und gehen Sie nicht davon aus, dass ein Zusammenhang zwischen "Android" und dem Geräteformat besteht. Auf diese Weise funktioniert Ihr Code, wenn/wo immer Firefox auf anderen Telefon/Tablet-Betriebssystemen oder Android für Laptops eingesetzt wird. Verwenden Sie außerdem 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).

Hier ist x.y die Version von macOS (zum Beispiel macOS 10.15). Ab 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-Zeichenfolge gemeldet werden. ARM-basierte Macs werden in der User-Agent-Zeichenfolge 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 sind unten angegeben.

Firefox für Android enthält die Android-Version als Teil des platform-Tokens. Für verbesserte Interoperabilität meldet der Browser, wenn er unter einer Version unter 4 ausgeführt wird, 4.4. Android-Versionen ab 4 geben die Version genau an. Beachten Sie, dass derselbe Gecko—mit denselben Fähigkeiten—auf allen Android-Versionen bereitgestellt wird.

Seit Version 1 wird Focus von Android WebView betrieben 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 wider, enthalten jedoch kein Mobile-Token.

Ab Version 6 können Benutzer sich dafür entscheiden, ein GeckoView-basiertes Focus für Android mit einer versteckten Präferenz zu verwenden: Es verwendet einen GeckoView-UA-String, um Gecko-Kompatibilität anzuzeigen.

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 selbst identifiziert.

Auf dem iPad erscheint die User-Agent-Zeichenfolge 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 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 aus einem iPhone XR-Simulator abgerufen und kann auf dem Gerät anders sein.

Version 3 (und wahrscheinlich früher) von Firefox für Fire TV verwenden einen User-Agent-String 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 einen User-Agent-String 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, enthalten einige Gerätehersteller leider ein Token im UA-String ihres Geräts, das ihre Geräte-ID darstellt. Wenn 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 davon, die wir bemerkt haben, haben die Form "NexusOne;", "ZTEOpen;" oder "Open C;" (beachten Sie, dass das Setzen eines Leerzeichens ebenfalls entmutigt wird). Wir stellen diese Informationen zur Verfügung, um Ihre UA-Erkennungslogik zu unterstützen, aber Mozilla entmutigt die Erkennung einer Geräte-ID in UA-Strings.

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 case-sensitiv, 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 gehören dem Mozilla-Produktteam und bezeichnen Versionen mit neuen Funktionen (z. B.: v1.1, 1.2, etc.). Die dritte Ziffer wird regelmäßig mit Versions-Tags (ungefähr alle 6 Wochen) für Sicherheitsupdates erhöht, und die vierte gehört dem OEM.

• Empfehlungen zur Erkennung der UA-Zeichenfolge für Browser-übergreifende Unterstützung
• navigator.userAgent