/random-http-useragent

Get a random and legit user-agent :shipit: for your HTTP client

Primary LanguageJavaScriptMIT LicenseMIT

Get a random and legit user-agent :shipit: for your HTTP client

Coverage Status Known Vulnerabilities Version Downloads

Stores and randomly accesses a HTTP user agent from an available list of user agents in disk.

Features

  • Randomly ⚑ pick between 899 unique user agents βœ…
  • HTTP user agents are stored πŸ’Ύ in a disk file to avoid filling up your app's memory space βœ…
  • File disk reads are optimized πŸƒ to only read as much as needed βœ…
  • Cache results using memoizee βœ…
  • Supports Bluebird 🐦 promises βœ…

How to install

npm install random-http-useragent -g

How to use

Use it in your terminal

random-http-useragent

Use it in your app

Get a random user agent

const RandomHttpUserAgent = require('random-http-useragent')

RandomHttpUserAgent.get()
  .then((userAgent) => console.log(userAgent))
  .catch((error) => console.error(error.message))

Cache returned user agents for 2 minutes

const RandomHttpUserAgent = require('random-http-useragent')

RandomHttpUserAgent.configure({ memoizee: { maxAge: 120000 } })

RandomHttpUserAgent.get()
  .then((userAgent) => console.log(userAgent))
  .catch((error) => console.error(error.message))

How to contribute

You can contribute either with code (e.g., new features, bug fixes and documentation) or by donating 5 EUR. You can read the contributing guidelines for instructions on how to contribute with code.

All donation proceedings will go to the Sverige fΓΆr UNHCR, a swedish partner of the UNHCR - The UN Refugee Agency, a global organisation dedicated to saving lives, protecting rights and building a better future for refugees, forcibly displaced communities and stateless people.

Used by

  • request-on-steroids - An HTTP client ✨ with retry, circuit-breaker and tor support πŸ“¦ out-of-the-box
  • facebook-login-for-robots - Facebook Login for πŸ€– robots
  • browser-as-a-service - A web browser 🌎 hosted as a service, to render your JavaScript web pages as HTML
  • pollmommy - ⭐️ Hack your πŸ™ˆ vote out of πŸ“ˆ Polldaddy surveys - used by πŸ’° BBC, Microsoft, Forbes, Pfizer, IBM

License

Read the license for permissions and limitations.