Nutritious Potato Munchies
Have opinions about JavaScript? We want to hear them. Take the 2018 JavaScript Ecosystem Survey »

random-useragent

0.3.1 • Public • Published

random-useragent

NPM version Build Status Code Climate Coverage Status Dependency Status devDependency Status

NPM

Description

Get a random user agent (with an optional filter to select from a specific set of user agents).

Getting Started

Install the module with: npm install random-useragent

var random_useragent = require('random-useragent');
random_useragent.getRandom(); // gets a random user agent string

Documentation

.getRandom(filter)

Get a random user agent string (optionally using a filter).

Example Result:

'Mozilla/5.0 (Windows NT 6.2; rv:20.0) Gecko/20121202 Firefox/20.0'

.getRandomData(filter)

Get a random user agent's parsed data (optionally using a filter).

Example Result:

{
    "folder": "/Browsers - Windows/Legacy Browsers",
    "description": "Firefox 20.0 (Win 8 32)",
    "userAgent": "Mozilla/5.0 (Windows NT 6.2; rv:20.0) Gecko/20121202 Firefox/20.0",
    "appCodename": "",
    "appName": "",
    "appVersion": "",
    "platform": "",
    "vendor": "",
    "vendorSub": "",
    "browserName": "Firefox",
    "browserMajor": "20",
    "browserVersion": "20.0",
    "deviceModel": "",
    "deviceType": "",
    "deviceVendor": "",
    "engineName": "Gecko",
    "engineVersion": "20.0",
    "osName": "Windows",
    "osVersion": "8",
    "cpuArchitecture": ""
}

.getAll(filter)

Get an array of all the user agent strings (optionally using a filter).

.getAllData(filter)

Get an array of all the parsed user agent data (optionally using a filter).

Examples

Get a random user agent string:

random_useragent.getRandom();

Get a random Firefox user agent string:

random_useragent.getRandom(function (ua) {
    return ua.browserName === 'Firefox';
});

Get a random user agent with a version >= 20:

random_useragent.getRandom(function (ua) {
    return parseFloat(ua.browserVersion) >= 20;
});

Source Of User Agents

The collection of user agents is pulled from the large, regularly updated xml file provided by the author of User Agent Switcher, which is located here:

Release History

Version 0.1.0 (Released June 4, 2014)

  • initial release

License

Copyright (c) 2014 skratchdot
Licensed under the MIT license.

install

npm i random-useragent

Downloadsweekly downloads

782

version

0.3.1

license

MIT

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
Report a vulnerability