Compatibility/UADetectionLibraries: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(I added a more current Java parser, the YAUAA, and also a parser for Scala)
 
(116 intermediate revisions by 5 users not shown)
Line 1: Line 1:
= User Agent Detection Libraries =
= User Agent Detection Libraries =


This is a list of User Agent detection libraries to be tested for compatibility with Firefox OS and Firefox for Android. This may also include general purpose JS libraries that include some kind of UA detection.
This is a list of [[UserAgent|User Agent]] detection libraries to be tested for [[Compatibility/Mobile|compatibility with]] Firefox OS and Firefox for Android. This may also include general purpose JS libraries that include some kind of UA detection.


The end goal is to contact these sites or (even better, in the case of open source libraries) provide patches so our mobile browsers are correctly identified as mobile (and not served desktop content or blocked outright).
The end goal is to '''contact these sites''' or (even better, in the case of open source libraries) '''provide patches''' so our mobile browsers are correctly identified as mobile (and not served desktop content or blocked outright).
 
NOTE: This page won't be actively updated anymore. You can watch the [https://bugzilla.mozilla.org/show_bug.cgi?id=915706 meta bug], or track progress at https://github.com/miketaylr/arewedetectableyet/.




Line 9: Line 11:


Firefox Mobile for Android:
Firefox Mobile for Android:
* <code>Mozilla/5.0 (Android; Mobile; rv:23.0) Gecko/23.0 Firefox/23.0</code>
* <code>Mozilla/5.0 (Android; Mobile; rv:24.0) Gecko/24.0 Firefox/24.0</code>


Firefox OS:
Firefox OS phones:
* <code>Mozilla/5.0 (Mobile; rv:18.0) Gecko/18.0 Firefox/18.0</code>
* <code>Mozilla/5.0 (Mobile; rv:18.0) Gecko/18.0 Firefox/18.0</code>


== Libraries to be tested ==
Firefox OS tablets:
* <code>Mozilla/5.0 (Tablet; rv:29.0) Gecko/29.0 Firefox/29.0</code>
 
Some known Firefox OS UA strings with device ids (found in bugzil.la/873385):
* <code>Mozilla/5.0 (Mobile; ZTEOPEN; rv:18.1) Gecko/18.1 Firefox/18.1</code>
* <code>Mozilla/5.0 (Mobile; HUAWEIY300-F1; rv:18.1) Gecko/18.1 Firefox/18.1</code>
* <code>Mozilla/5.0 (Mobile; LG-D300; rv:18.1) Gecko/18.1 Firefox/18.1</code>
* <code>Mozilla/5.0 (Mobile; ALCATELOneTouch4012X; rv:18.1) Gecko/18.1 Firefox/18.1</code>


See also https://developer.mozilla.org/en-US/docs/Gecko_user_agent_string_reference#Firefox_OS_version_number.


=== Java ===
== Libraries to be tested ==
* UADetector https://github.com/before/uadetector
* User Agent Utils https://github.com/HaraldWalker/user-agent-utils


=== JavaScript ===
=== JavaScript ===
* Device.js https://github.com/matthewhudson/device.js
 
* Dojo Toolkit https://github.com/dojo/ (see http://dojotoolkit.org/reference-guide/1.7/quickstart/browser-sniffing.html)
* Dojo Toolkit https://github.com/dojo/ (see http://dojotoolkit.org/reference-guide/1.7/quickstart/browser-sniffing.html)
** Do we need to recommend a ffos or fxos token be added to the module? https://github.com/dojo/dojo/blob/master/sniff.js
** Do we need to recommend a ffos or fxos token be added to the module? https://github.com/dojo/dojo/blob/master/sniff.js
* jQuery Mobile http://jquerymobile.com (FF for Android listed as A-grade support, FFOS not mentioned).
**TODO: run tests (https://github.com/jquery/jquery-mobile/blob/master/js/jquery.mobile.support.js)
* Mootools (https://github.com/mootools/mootools-core/blob/master/Source/Browser/Browser.js)


=== Multiple Languages ===
=== Server Modules ===
 
Feel free to add new ones.
 
=== Perl ===
* HTTP::BrowserDetect https://github.com/oalders/http-browserdetect
 
=== PHP ===
* Detector (Drupal) https://drupal.org/project/detector
* Mobile-Detect https://github.com/serbanghita/Mobile-Detect / http://mobiledetect.net/
* PHP Mobile Detect http://code.google.com/p/php-mobile-detect/
* PHP User Agent https://github.com/ornicar/php-user-agent
* PHP User Agent Parser https://github.com/donatj/PhpUserAgent
* PHP User Agent Parser https://bitbucket.org/hkgoldenmra/php-user-agent-parser
* Mobile Detect Bundle https://github.com/suncat2000/MobileDetectBundle
* WordPress Mobile Detect http://wordpress.org/plugins/wp-mobile-detect/
* Categorizr https://github.com/bjankord/Categorizr


=== Python ===
* NetBiscuits http://www.netbiscuits.com/ (in contact via email.)
* Python User Agents https://github.com/selwin/python-user-agents
* Django Mobile https://github.com/gregmuellegger/django-mobile
* minidetector https://github.com/saschwarz/minidetector/network
* GoMobile (Plone) https://pypi.python.org/pypi/gomobile.mobile
 
=== Ruby ===
* user-agent https://github.com/visionmedia/user-agent/network
** note: TJ's lib is unmaintained but there appears to be a number of active forks.
* agent_orange https://github.com/kevinelliott/agent_orange
* browser https://github.com/fnando/browser
* Mobvious https://github.com/jistr/mobvious
* UserAgent https://github.com/josh/useragent
 
=== Server Modules ===
* Apache Mobile Filter http://www.apachemobilefilter.org/
* (NGINX has a DeviceAtlas module)
* Detect Right http://detectright.com/
* NetBiscuits http://www.netbiscuits.com/
* OpenDDR http://openddr.org/


== Tested, issues reported in Bugzilla ==
== Tested, issues reported in Bugzilla ==
'''Meta Bug: [https://bugzilla.mozilla.org/show_bug.cgi?id=915706]'''
'''Meta Bug: [https://bugzilla.mozilla.org/show_bug.cgi?id=915706 915706]'''
* http://detectmobilebrowsers.com/ [https://bugzilla.mozilla.org/show_bug.cgi?id=914241 Bug 914241*]
* is-mobile [https://bugzilla.mozilla.org/show_bug.cgi?id=914231 Bug 914231]
* Platform.js [https://bugzilla.mozilla.org/show_bug.cgi?id=913633 Bug 913633]
* UA.js [https://bugzilla.mozilla.org/show_bug.cgi?id=913189 Bug 913189] *
* Woothee [https://bugzilla.mozilla.org/show_bug.cgi?id=914313 Bug 914313] *
* WPTouch (WordPress) [https://bugzilla.mozilla.org/show_bug.cgi?id=909420 Bug 909420]
 
*fixed


== Libraries known to be compatibile ==
== Libraries known to be compatibile ==
=== Go ===
=== Go ===
* UserAgent https://github.com/mssola/user_agent
* UserAgent https://github.com/mssola/user_agent
* Woothee Go https://github.com/woothee/woothee-go
=== Java ===
* UADetector https://github.com/before/uadetector
* User Agent Utils [https://bugzilla.mozilla.org/show_bug.cgi?id=915727 915727] *
* Woothee Java https://github.com/woothee/woothee-java
* YAUAA https://github.com/nielsbasjes/yauaa
=== Scala ===
* UA-Parser https://github.com/ua-parser/uap-scala


=== JavaScript ===
=== JavaScript ===
* Detect.js https://github.com/darcyclarke/Detect.js
* Detect.js https://github.com/darcyclarke/Detect.js
* Detectizr [https://bugzilla.mozilla.org/show_bug.cgi?id=956998 Bug 956998] *
* Device.js [https://bugzilla.mozilla.org/show_bug.cgi?id=915853 915853] *
* Express Device https://npmjs.org/package/express-device
* Express Device https://npmjs.org/package/express-device
* isMobile https://github.com/kaimallea/isMobile
* isMobile https://github.com/kaimallea/isMobile
* is-mobile [https://bugzilla.mozilla.org/show_bug.cgi?id=914231 Bug 914231] *
* JS Redirection Mobile [https://bugzilla.mozilla.org/show_bug.cgi?id=932458 Bug 932458]*
* jQuery Mobile
* Mobile Agent https://github.com/fabdrol/mobileagent
* Mobile Agent https://github.com/fabdrol/mobileagent
* Mootools (https://github.com/mootools/mootools-core/blob/master/Source/Browser/Browser.js)
* Node User Agent Parse https://github.com/jujhars13/node-user-agent-parse
* Node User Agent Parse https://github.com/jujhars13/node-user-agent-parse
* Platform.js [https://bugzilla.mozilla.org/show_bug.cgi?id=913633 Bug 913633]
* ua-parser-js https://github.com/faisalman/ua-parser-js
* ua-parser-js https://github.com/faisalman/ua-parser-js
* useragent https://github.com/3rd-Eden/useragent
* useragent https://github.com/3rd-Eden/useragent
* Woothee JS https://github.com/woothee/woothee-js
* YUI - http://yuilibrary.com/yui/docs/yui/yui-ua.html
* YUI - http://yuilibrary.com/yui/docs/yui/yui-ua.html
* UA.js [https://bugzilla.mozilla.org/show_bug.cgi?id=913189 Bug 913189] *


=== Multiple Languages ===
=== Multiple Languages ===
* ua-parser (multiple languages) https://github.com/tobie/ua-parser
* ua-parser (multiple languages) https://github.com/tobie/ua-parser
* Mobile ESP http://blog.mobileesp.com/
** Some ports of this are compatible, in contact with maintainer via email.
* detectmobilebrowsers.com [https://bugzilla.mozilla.org/show_bug.cgi?id=914241 Bug 914241*]
* Woothee https://github.com/woothee/woothee
=== Perl ===
* HTTP::BrowserDetect https://github.com/oalders/http-browserdetect
* Woothee Perl https://github.com/woothee/woothee-perl
=== PHP ===
* Categorizr https://github.com/bjankord/Categorizr (Note: no longer maintained)
* Detector (Drupal) https://drupal.org/project/detector / http://detector.dmolsen.com/
* Mobile-Detect https://github.com/serbanghita/Mobile-Detect / http://mobiledetect.net/ / http://code.google.com/p/php-mobile-detect/
* Mobile Detect Bundle https://github.com/suncat2000/MobileDetectBundle
* PHP User Agent https://github.com/ornicar/php-user-agent
* PHP User Agent Parser https://github.com/donatj/PhpUserAgent
* Woothee PHP https://github.com/woothee/woothee-php
* WordPress Mobile Detect http://wordpress.org/plugins/wp-mobile-detect/
* WPTouch (WordPress) [https://bugzilla.mozilla.org/show_bug.cgi?id=909420 Bug 909420]
=== Python ===
* Django Mobile https://github.com/gregmuellegger/django-mobile
* GoMobile (Plone) https://pypi.python.org/pypi/gomobile.mobile
* minidetector https://github.com/saschwarz/minidetector/network
* Python User Agents https://github.com/selwin/python-user-agents
* Woothee Python https://github.com/woothee/woothee-python
=== Ruby ===
* agent_orange https://github.com/kevinelliott/agent_orange
* browser https://github.com/fnando/browser
* Mobvious https://github.com/jistr/mobvious (uses MobileESP (ruby port is at least compatible)
* UserAgent https://github.com/josh/useragent (makes no mobile/non-mobile distinction)
* User Agent Parser https://github.com/toolmantim/user_agent_parser
* Woothee Ruby https://github.com/woothee/woothee-ruby


=== Server Detection Frameworks ===
=== Server Detection Frameworks ===
* Apache Mobile Filter [https://bugzilla.mozilla.org/show_bug.cgi?id=916250 916250]
* 51 Degrees http://51degrees.mobi/Products/DeviceDetection.aspx
* 51 Degrees http://51degrees.mobi/Products/DeviceDetection.aspx
* Device Atlas https://deviceatlas.com/device-data/user-agent-tester (it recognizes us as FFOS, but some of the data isn't quite accurate (says we dont support geolocation) and has some oddities like isBrowser: False (?)
* Detect Right http://detectright.com/
* DeviceAtlas https://deviceatlas.com/device-data/user-agent-tester  
* http://handsetdetection.com [https://bugzilla.mozilla.org/show_bug.cgi?id=957205 Bug 957205]
* OpenDDR http://openddr.org/
* WURFL (1.4) http://tools.scientiamobile.com/?user-agent-string=Mozilla%2F5.0+%28Mobile%3B+rv%3A18.0%29+Gecko%2F18.0+Firefox%2F18.0
* WURFL (1.4) http://tools.scientiamobile.com/?user-agent-string=Mozilla%2F5.0+%28Mobile%3B+rv%3A18.0%29+Gecko%2F18.0+Firefox%2F18.0


[[Category:Web Compatibility]]
[[Category:Web Compatibility|UA Detection]]

Latest revision as of 02:02, 12 February 2021

User Agent Detection Libraries

This is a list of User Agent detection libraries to be tested for compatibility with Firefox OS and Firefox for Android. This may also include general purpose JS libraries that include some kind of UA detection.

The end goal is to contact these sites or (even better, in the case of open source libraries) provide patches so our mobile browsers are correctly identified as mobile (and not served desktop content or blocked outright).

NOTE: This page won't be actively updated anymore. You can watch the meta bug, or track progress at https://github.com/miketaylr/arewedetectableyet/.


UA strings to test with:

Firefox Mobile for Android:

  • Mozilla/5.0 (Android; Mobile; rv:24.0) Gecko/24.0 Firefox/24.0

Firefox OS phones:

  • Mozilla/5.0 (Mobile; rv:18.0) Gecko/18.0 Firefox/18.0

Firefox OS tablets:

  • Mozilla/5.0 (Tablet; rv:29.0) Gecko/29.0 Firefox/29.0

Some known Firefox OS UA strings with device ids (found in bugzil.la/873385):

  • Mozilla/5.0 (Mobile; ZTEOPEN; rv:18.1) Gecko/18.1 Firefox/18.1
  • Mozilla/5.0 (Mobile; HUAWEIY300-F1; rv:18.1) Gecko/18.1 Firefox/18.1
  • Mozilla/5.0 (Mobile; LG-D300; rv:18.1) Gecko/18.1 Firefox/18.1
  • Mozilla/5.0 (Mobile; ALCATELOneTouch4012X; rv:18.1) Gecko/18.1 Firefox/18.1

See also https://developer.mozilla.org/en-US/docs/Gecko_user_agent_string_reference#Firefox_OS_version_number.

Libraries to be tested

JavaScript

Server Modules

Tested, issues reported in Bugzilla

Meta Bug: 915706

Libraries known to be compatibile

Go

Java

Scala

JavaScript

Multiple Languages

Perl

PHP

Python

Ruby

Server Detection Frameworks

Retrieved from "https://wiki.allizom.org/index.php?title=Compatibility/UADetectionLibraries&oldid=1233705"