JSPM

user-agents

0.0.15
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 110002
  • Score
    100M100P100Q195332F
  • License BSD-2-Clause

A JavaScript library for generating random user agents.

Package Exports

  • user-agents

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 (user-agents) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

User Agents

Build Status Build Status License NPM Version          Tweet Share on Facebook Share on Reddit Share on Hacker News

User Agents

User Agents is a JavaScript module for generating random user agents according to how frequently they're used in the wild. This is useful for web scraping because it's often desired to create realistic traffic patterns. There are several other similar projects for generating random user agents, but User Agents is the only one that automatically publishes new versions with updated data on a regular basis. This ensures that your user agents will always be realistic and up to date.

Installation

The User Agents package is available on npm with the package name user-agents. You can install it using your favorite JavaScript package manager in the usual way.

# With npm: npm install user-agents
# With pnpm: pnpm install user-agents
# With yarn:
yarn add user-agents

Usage

The userAgents.random() method can be used to generate a random user agent. The most common user agents are weighted with higher probabilities so that the randomly generated user agents will follow realistic probability distributions. For example, the following code snippet will generate five random user agents based on these probabilities.

// Import the User Agents package.
const userAgents = require('user-agents');

// Log out five random user agents.
for (let i = 0; i < 5; i++) {
    const userAgent = userAgents.random();
    console.log(userAgents);
};

The output will be random, and will also depend on which package version you're using, but a typical output would look something like this.

Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:61.0) Gecko/20100101 Firefox/61.0
Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.1.2 Safari/605.1.15
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/67.0.3396.99 Safari/537.36

Acknowledgements

The user agent frequency data used in this library is currently provided by the Will's House Tech Blog.

Contributing

Contributions are welcome, but please follow these contributor guidelines outlined in CONTRIBUTING.md.

License

Slice is licensed under a BSD 2-Clause License and is copyright Intoli, LLC.