Merge branch 'master' into gh-pages

package.json

@@ -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": [

readme.md

@@ -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
+* Source	: https://github.com/faisalman/ua-parser-js
-* License	: GPLv2
+* 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
+    // by default it takes ua string from current browser's window.navigator
-    
+    console.log(UAParser.result);
-    console.log(parser);
     /*
         /// 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();
+    console.log(UAParser.result.browser);  // {name: "Chromium", major: "15", version: "15.0.874.106"}
-    var engine = parser.getEngine();
+    console.log(UAParser.result.engine);   // {name: "AppleWebKit", version: "535.2"}
-    var os = parser.getOS();
+    console.log(UAParser.result.os);       // {name: "Ubuntu", version: "11.10"}
-    
-    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"}
     
+    // 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>>

ua-parser.js

@@ -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) {
+                    for (k in props) {
-                    if (props.hasOwnProperty(j)) {
+                        if (props.hasOwnProperty(k)) {
-                    result[props[j]] = 'unknown';
+                            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(uastring || ua, [
-
-        return regxMap(this.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
+                /(?:android.+crmo|crios)\/((\d+)?[\w\.]+)/i,                        // Chrome for Android/iOS
-            ], [['name', /.+/g, 'Chrome'], 'version', 'major'], [
+                ], [['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;
+    }
+})();