github_mirrors/ua-parser-js
3
0
Fork 1
mirror of https://github.com/faisalman/ua-parser-js.git synced 2025-09-27 16:08:47 +03:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'master' into gh-pages

Browse Source
This commit is contained in:
Faisalman 2012-07-29 02:39:17 +07:00
commit d1c68cf71b
3 changed files with 278 additions and 174 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
package.json
View File

@ -1,7 +1,7 @@
{
"title" : "UA-Parser.js",
"name" : "ua-parser-js",
"version" : "0.1.0",
"version" : "0.3.0",
"author" : {
"name" : "Faisal Salman",
"email" : "fyzlman@gmail.com",
@ -11,7 +11,10 @@
"keywords" : [
"user-agent",
"parser",
"browser"
"browser",
"engine",
"os",
"device"
],
"homepage" : "http://faisalman.github.com/ua-parser-js",
"contributors": [

63
readme.md
View File

@ -4,12 +4,24 @@ JavaScript-based user-agent parser
* Author : Faisalman <<fyzlman@gmail.com>>
* Home : http://faisalman.github.com/ua-parser-js
* Source : http://github.com/faisalman/ua-parser-js
* License : GPLv2
* Source : https://github.com/faisalman/ua-parser-js
* License : GPLv2 & MIT
## Features
Get detailed type and version of web browser, layout engine, and operating system.
Get detailed type and version of web browser, layout engine, operating system, and device.
## Methods
* `getBrowser([uastring])`
* `getDevice([uastring])`
* `getEngine([uastring])`
* `getOS([uastring])`
* `setUA(uastring)`
## Properties
* `result`
## Example
@ -17,15 +29,18 @@ Get detailed type and version of web browser, layout engine, and operating syste
<script type="text/javascript" src="ua-parser.js"></script>
<script type="text/javascript">
var parser = new uaparser(); // if no string given as parameter, by default it takes ua string from current window.navigator
console.log(parser);
// by default it takes ua string from current browser's window.navigator
console.log(UAParser.result);
/*
/// this will print an object structured like this:
{
browser: {
name: "",
major: "",
version: "",
major: ""
},
device: {
name: "",
version: ""
},
engine: {
@ -35,24 +50,42 @@ Get detailed type and version of web browser, layout engine, and operating syste
os: {
name: "",
version: ""
},
device: {
name: "",
version: ""
}
}
*/
// let's test a custom user-agent string as an example
parser.ua = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/535.2 (KHTML, like Gecko) Ubuntu/11.10 Chromium/15.0.874.106 Chrome/15.0.874.106 Safari/535.2";
var uastr = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/535.2 (KHTML, like Gecko) Ubuntu/11.10 Chromium/15.0.874.106 Chrome/15.0.874.106 Safari/535.2";
UAParser.setUA(uastr);
var browser = parser.getBrowser();
var engine = parser.getEngine();
var os = parser.getOS();
console.log(browser); // {name: "Chromium", major: "15", version: "15.0.874.106"}
console.log(engine); // {name: "AppleWebKit", version: "535.2"}
console.log(os); // {name: "Ubuntu", version: "11.10"}
console.log(UAParser.result.browser); // {name: "Chromium", major: "15", version: "15.0.874.106"}
console.log(UAParser.result.engine); // {name: "AppleWebKit", version: "535.2"}
console.log(UAParser.result.os); // {name: "Ubuntu", version: "11.10"}
// let's take another test please
UAParser.setUA("Mozilla/5.0 (compatible; Konqueror/4.1; OpenBSD) KHTML/4.1.4 (like Gecko)").getOS().name; // prints "OpenBSD"
</script>
```
## Using node.js
```js
var parser = require('ua-parser');
var ua1 = 'Mozilla/5.0 (PlayBook; U; RIM Tablet OS 1.0.0; en-US) AppleWebKit/534.11 (KHTML, like Gecko) Version/7.1.0.7 Safari/534.11';
var ua2 = 'Midori/0.2 (X11; Linux; U; cs-cz) WebKit/531.2+';
parser.setUA(ua1).getDevice().name; // prints "PlayBook"
parser.getOS() // prints {name: "RIM Tablet OS", version: "1.0.0"}
parser.getOS(ua2) // prints {name: "Linux", version: undefined}
parser.getOS() // prints {name: "RIM Tablet OS", version: "1.0.0"}
parser.getEngine().name; // prints "AppleWebKit"
```
## License
Copyright © 2012 Faisalman <<fyzlman@gmail.com>>

128
ua-parser.js
View File

@ -1,11 +1,14 @@
// UA-Parser.js v0.1.1
// UA-Parser.js v0.3.0
// Lightweight JavaScript-based user-agent parser
// https://github.com/faisalman/ua-parser-js
//
// Copyright © 2012 Faisalman
// Licensed under GPLv2
// Licensed under GPLv2 & MIT
function uaparser (uastring) {
(function () {
function UAParser (uastring) {
var ua = uastring || typeof window !== 'undefined' ? window.navigator.userAgent : "";
// regexp mapper
var regxMap = function (ua) {
@ -14,7 +17,7 @@ function uaparser (uastring) {
for (i = 1; i < arguments.length; i += 2) {
var regex = arguments[i];
var props = arguments[i + 1];
var isMatch = false;
var isMatchFound = false;
for (j = 0; j < regex.length; j++) {
var match = regex[j].exec(ua);
//console.log(match);
@ -26,30 +29,35 @@ function uaparser (uastring) {
result[props[k][0]] = props[k][1];
l -= 1;
} else if (typeof props[k] === 'object' && props[k].length === 3) {
result[props[k][0]] = (!!match[k + l]) ? match[k + l].replace(props[k][1], props[k][2]) : 'unknown';
result[props[k][0]] = (!!match[k + l]) ? match[k + l].replace(props[k][1], props[k][2]) : undefined;
} else {
result[props[k]] = (!!match[k + l]) ? match[k + l] : 'unknown';
result[props[k]] = (!!match[k + l]) ? match[k + l] : undefined;
}
};
isMatch = true;
}
isMatchFound = true;
break;
}
};
if (!isMatch) {
}
if (!isMatchFound) {
result = {};
for (j in props) {
if (props.hasOwnProperty(j)) {
result[props[j]] = 'unknown';
}
};
for (k in props) {
if (props.hasOwnProperty(k)) {
if (typeof props[k] == 'object') {
result[props[k][0]] = undefined;
} else {
break;
result[props[k]] = undefined;
}
}
}
} else {
return result;
}
}
};
return result;
};
var mapper = {
os : {
win: function (str, match) {
switch (match.toLowerCase()) {
case 'nt 5.0':
@ -67,17 +75,16 @@ function uaparser (uastring) {
return match;
};
}
}
};
this.ua = uastring || window.navigator.userAgent;
this.getBrowser = function (uastring) {
this.getBrowser = function() {
return regxMap(this.ua, [
return regxMap(uastring || ua, [
// Mixed
/(kindle)\/((\d+)?[\w\.]+)/i, // Kindle
/(lunpropsape|maxthon|netfront|jasmine)[\/\s]?((\d+)?[\w\.]+)/i, // Lunpropsape/Maxthon/Netfront/Jasmine
/(lunascape|maxthon|netfront|jasmine)[\/\s]?((\d+)?[\w\.]+)/i, // Lunascape/Maxthon/Netfront/Jasmine
// Presto based
/(opera\smini)\/((\d+)?[\w\.-]+)/i, // Opera Mini
@ -92,8 +99,8 @@ function uaparser (uastring) {
/(chromium|flock|rockmelt|midori|epiphany)\/((\d+)?[\w\.]+)/i, // Chromium/Flock/RockMelt/Midori/Epiphany
/(chrome|omniweb|arora|dolfin)\/((\d+)?[\w\.]+)/i, // Chrome/OmniWeb/Arora/Dolphin
], ['name', 'version', 'major'], [
/android.+(crmo)\/((\d+)?[\w\.]+)/i, // Chrome for Android
], [['name', /.+/g, 'Chrome'], 'version', 'major'], [
/(?:android.+crmo|crios)\/((\d+)?[\w\.]+)/i, // Chrome for Android/iOS
], [['name', 'Chrome'], 'version', 'major'], [
/(mobile\ssafari|safari|konqueror)\/((\d+)?[\w\.]+)/i, // Safari/Konqueror
/(applewebkit|khtml)\/((\d+)?[\w\.]+)/i,
@ -108,9 +115,9 @@ function uaparser (uastring) {
], ['name', 'version', 'major']);
};
this.getEngine = function() {
this.getEngine = function (uastring) {
return regxMap(this.ua, [
return regxMap(uastring || ua, [
/(presto)\/([\w\.]+)/i, // Presto
/([aple]*webkit|trident)\/([\w\.]+)/i, // Webkit/Trident
@ -121,13 +128,13 @@ function uaparser (uastring) {
], ['version', 'name']);
};
this.getOS = function() {
this.getOS = function (uastring) {
return regxMap(this.ua, [
return regxMap(uastring || ua, [
// Windows based
/(windows\sphone\sos|windows)\s+([\w\.\s]+)*/i, // Windows
], ['name', ['version', /(nt\s[\d\.]+)/gi, mapper.win]], [
], ['name', ['version', /(nt\s[\d\.]+)/gi, mapper.os.win]], [
// Mobile/Embedded OS
/(blackberry).+version\/([\w\.]+)/i, // Blackberry
@ -164,4 +171,65 @@ function uaparser (uastring) {
/(macintosh|unix|minix|beos)[\/\s]?()*/i
], ['name', 'version']);
};
};
this.getDevice = function (uastring) {
return regxMap(uastring || ua, [
/\((ip[honead]+|playbook);/i, // iPod/iPhone/iPad/PlayBook
/(blackberry)[\s-]?(\w+)/i, // BlackBerry
/(blackberry|benq|nokia|palm(?=\-)|sonyericsson|acer|asus|dell|nexus|zte)[\s_-]?([\w-]+)*/i,
// BenQ/Nokia/Palm/Sony-Ericsson/Acer/Asus/Dell/Nexus/ZTE
/(hp)\s([\w\s]+)/i, // HP iPAQ
/(hp).+(touchpad)/i, // HP TouchPad
/(kindle)\/([\w\.]+)/i, // Kindle
/(lg)[e;\s-]+(\w+)*/i, // LG
/(nintendo|playstation)\s([wids3portable]+)/i // Nintendo/Playstation
], ['name', 'version'], [
/(htc)[;_\s-]+([\w\s]+(?=\))|[\w]+)*/i, // HTC
/(zte)-([\w]+)*/i
], ['name', ['version', /_/g, ' ']], [
/\s(milestone|mz601|droid[2x]?|xoom)[globa\s]*\sbuild\//i, // Motorola
/mot[\s-]?(\w+)*/i
], [['name', 'Motorola'], 'version'], [
/(s[cgp]h-\w+|gt-\w+|galaxy\snexus)/i, // Samsung
/sam[sung]*[\s-]*(\w+-?[\w-]*)*/i,
/sec-(sgh\w+)/i
], [['name', 'Samsung'], 'version'], [
/(transfo[prime\s]{4,10}\s\w+|(?:android).*eeepc)/i // Asus
], [['name', 'Asus'], 'version'], [
/sie-(\w+)*/i // Siemens
], [['name', 'Siemens'], 'version']);
};
this.setUA = function (uastring) {
ua = uastring || ua;
this.result = {
browser : this.getBrowser(),
engine : this.getEngine(),
os : this.getOS(),
device : this.getDevice()
};
return this;
};
this.setUA(ua);
};
var parser = new UAParser();
// check whether script is running inside node.js export as module
if (typeof exports !== 'undefined' && this.toString() !== '[object DOMWindow]') {
if (typeof module !== 'undefined' && module.exports) {
exports = module.exports = parser;
}
exports.UAParser = parser;
} else {
this['UAParser'] = parser;
}
})();