real-user-agent

real-user-agent

Will the real user agent please stand up?

Get an up-to-date user-agent string, sourced from the most common user agents. To avoid each use of this module hammering the source, the data is now self-hosted in this repository, available via cdn. A simple local cache, invalidated every 2 hours, prevents extra requests. A data cap is implemented in the request. The local ua.json is used as a fallback in case the data is corrupt or host is unreachable.

const userAgent = require('real-user-agent');

// most common user-agent string
const ua = await userAgent();

// array of top 10 most common user-agent strings
const topTen = await userAgent.all();

// round robin top 10 most common user-agents
const randomUA = await userAgent.cycle();
const anotherUA = await userAgent.cycle();

// 5th most common user-agent
const fifth = await userAgent.cycle(4);

// random user-agent
const randomUA = await userAgent.cycle(Math.random());

const request = require('request');
const userAgent = require('real-user-agent');
request({
  url: 'https://api.github.com/repos/fijimunkii/real-user-agent',
  headers: {
    'user-agent': await userAgent()
  }
});

Authors

fijimunkii

License

This project is licensed under the ISC License - see the LICENSE file for details.