https://github.com/hfreire/random-http-useragent

Get a random and legit user-agent :shipit: for your HTTP client
https://github.com/hfreire/random-http-useragent

github-actions http http-client http-server http-user-agent random random-generation

Last synced: 18 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/hfreire/random-http-useragent
• Owner: hfreire
• License: mit
• Created: 2017-02-04T17:56:04.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-09-07T08:09:42.000Z (2 months ago)
• Last Synced: 2024-10-13T09:16:03.709Z (about 1 month ago)
• Topics: github-actions, http, http-client, http-server, http-user-agent, random, random-generation
• Language: JavaScript
• Homepage:
• Size: 2.13 MB
• Stars: 10
• Watchers: 2
• Forks: 1
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md

Awesome Lists containing this project

README

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

[![](https://github.com/hfreire/random-http-useragent/workflows/ci/badge.svg)](https://github.com/hfreire/random-http-useragent/actions?workflow=ci)

[![Coverage Status](https://coveralls.io/repos/github/hfreire/random-http-useragent/badge.svg?branch=master)](https://coveralls.io/github/hfreire/random-http-useragent?branch=master)

[![Known Vulnerabilities](https://snyk.io/test/github/hfreire/random-http-useragent/badge.svg)](https://snyk.io/test/github/hfreire/random-http-useragent)

[![](https://img.shields.io/github/release/hfreire/random-http-useragent.svg)](https://github.com/hfreire/random-http-useragent/releases)

[![Version](https://img.shields.io/npm/v/random-http-useragent.svg)](https://www.npmjs.com/package/random-http-useragent)

[![Downloads](https://img.shields.io/npm/dt/random-http-useragent.svg)](https://www.npmjs.com/package/random-http-useragent)

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

### Features

* Randomly :zap: pick between 899 unique user agents :white_check_mark:

* HTTP user agents are stored :floppy_disk: in a disk file to avoid filling up your app's memory space :white_check_mark:

* File disk reads are optimized :running: to only read as much as needed :white_check_mark:

* Cache results using [memoizee](https://github.com/medikoo/memoizee) :white_check_mark:

* Supports [Bluebird](https://github.com/petkaantonov/bluebird) :bird: promises :white_check_mark:

### 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

```javascript

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

```javascript

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](https://paypal.me/hfreire/5). You can read the [contributing guidelines](CONTRIBUTING.md) for instructions on how to contribute with code.

All donation proceedings will go to the [Sverige för UNHCR](https://sverigeforunhcr.se), a swedish partner of the [UNHCR - The UN Refugee Agency](http://www.unhcr.org), 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](https://github.com/hfreire/request-on-steroids) - An HTTP client :sparkles: with retry, circuit-breaker and tor support :package: out-of-the-box

* [facebook-login-for-robots](https://github.com/hfreire/facebook-login-for-robots) - Facebook Login for 🤖 robots

* [browser-as-a-service](https://github.com/hfreire/browser-as-a-service) - A web browser :earth_americas: hosted as a service, to render your JavaScript web pages as HTML

* [pollmommy](https://github.com/hfreire/pollmommy) - ⭐️ Hack your 🙈 vote out of 📈 Polldaddy surveys - used by 💰 BBC, Microsoft, Forbes, Pfizer, IBM

### License

Read the [license](./LICENSE.md) for permissions and limitations.