darcyclarke/Detect.js
darcyclarke/Detect.js has 639 GitHub stars and 199 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:22 UTC. Last push 2022-12-30.
What you can do
- User-Agent parsing (obviously)
- AMD/Common.js support
- device supports: manufacturer and type as well
- Custom regex builds using node.js
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
:mag: Library to detect browser, os and device based on the UserAgent String
AIREADME.md
OriginalDetect.js
Note: Detect.js is a JavaScript library to detect platforms, versions, manufacturers and types based on the navigator.userAgent string. This code is based on, and modified from, the original work of Tobie Langel's UA-Parser: https://github.com/tobie/ua-parser. UA-Parser is subsequently a port of BrowserScope's user agent string parser.
As initially touted, the biggest contribution to this code is the work of Steve Souders and the list of regex tests.
Features
- User-Agent parsing (obviously)
- AMD/Common.js support
- device, os and browser detection of:
namefamilyversionmajorminorpatch- device supports:
manufacturerandtypeas well
- Custom regex builds using node.js
Creating a Custom Build
Creating a custom build of the regex profiles will help reduce file size and is strongly recommended. The default detect.js and detect.min.js files include all regex profiles and is therefor much larger then, I'm sure, your needs.
- Install Node.js: https://github.com/joyent/node/wiki/Installation
- Edit
build/config.jswith you're preferred oss, devices and browsers - Run
node build/build.js --input=build/detect.js --output=build/detect.custom.js - The build script should create a custom version of Detect.js at
build/detect.custom.js
Example Use
Plain JS:
<script src="detect.js"></script>
/*
iPhone 4 Example User Agent:
Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_0 like Mac OS X; en-us) AppleWebKit/532.9 (KHTML, like Gecko) Version/4.0.5 Mobile/8A293 Safari/6531.22.7
*/
var ua = detect.parse(navigator.userAgent);
ua.browser.family // "Mobile Safari"
ua.browser.name // "Mobile Safari 4.0.5"
ua.browser.version // "4.0.5"
ua.browser.major // 4
ua.browser.minor // 0
ua.browser.patch // 5
ua.device.family // "iPhone"
ua.device.name // "iPhone"
ua.device.version // ""
ua.device.major // null
ua.device.minor // null
ua.device.patch // null
ua.device.type // "Mobile"
ua.device.manufacturer // "Apple"
ua.os.family // "iOS"
ua.os.name // "iOS 4"
ua.os.version // "4"
ua.os.major // 4
ua.os.minor // 0
ua.os.patch // null
Common.js:
var detect = require('detect');
var ua = detect.parse(navigator.userAgent);
...
Hacking
- Install development dependencies using
npm install. - Install the pre-commit hook by running
hooks/install.sh. - Kick off the default build (which will generate
detect.jsanddetect.min.js) withnpm start.
Credits
Thanks to Adriano Caheté and Julian
Licensing
- Some data contained in
build/regexes.jsis Copyright 2009 Google Inc. and available under the Apache License, Version 2.0. - All other code is licensed under a Dual MIT and GPL licence