Compatibility/UADetectionLibraries

User Agent Detection Libraries

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

See use cases for user agent (UA) detection for more context.

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).

	THIS PAGE MAY BE OUTDATED
	This article is in parts, or in its entirety, outdated. Hence, the information presented on this page may be incorrect, and should be treated with due caution until this flag has been lifted. Help by editing the article, or discuss its contents on the talk page.

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/Web/HTTP/Reference/Headers/User-Agent/Firefox

Libraries to be tested

JavaScript

• 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

Server Modules

• NetBiscuits http://www.netbiscuits.com/ (in contact via email.)

Tested, issues reported in Bugzilla

Meta Bug: 915706

Libraries known to be compatibile

Go

• 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 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

• Detect.js https://github.com/darcyclarke/Detect.js
• Detectizr Bug 956998 *
• Device.js 915853 *
• Express Device https://npmjs.org/package/express-device
• isMobile https://github.com/kaimallea/isMobile
• is-mobile Bug 914231 *
• JS Redirection Mobile Bug 932458*
• jQuery Mobile
• 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
• Platform.js Bug 913633
• ua-parser-js https://github.com/faisalman/ua-parser-js
• 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
• UA.js Bug 913189 *

Multiple Languages

• 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 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) 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

• Apache Mobile Filter 916250
• 51 Degrees http://51degrees.mobi/Products/DeviceDetection.aspx
• Detect Right http://detectright.com/
• DeviceAtlas https://deviceatlas.com/device-data/user-agent-tester
• http://handsetdetection.com 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