Package Exports

ua-parser-js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ua-parser-js) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

UA-Parser.js

JavaScript-based user-agent parser

Author : Faisalman <fyzlman@gmail.com>
Home : http://faisalman.github.com/ua-parser-js
Source : https://github.com/faisalman/ua-parser-js
License : GPLv2 & MIT

Features

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

<script type="text/javascript" src="ua-parser.js"></script>
<script type="text/javascript">
    
    // 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: "",
                version: "",
                major: ""
            },
            device: {
                name: "",
                version: ""
            },
            engine: {
                name: "",
                version: ""
            },
            os: {
                name: "",
                version: ""
            },
            device: {
                name: "",
                version: ""
            }
        }
    */

    // let's test a custom user-agent string as an example
    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);
    
    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

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

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.