@arndesk/user-agent-generator

Real-world mobile User-Agent strings for Android Chrome, iOS Safari, iOS Chrome (CriOS), and Android Facebook in-app WebView.

Requires Bun. Versions are baked into src/snapshot.json (no network on generate). Refresh about every 15 days with bun run update, then republish.

Install

bun add @arndesk/user-agent-generator

API

import { generate, generateFacebook } from "@arndesk/user-agent-generator";

generate({ android: 5, ios: 5 });
// 5 Android Chrome + 5 iOS Safari/CriOS strings

generate({ ios: 4, browser: "safari" });
// iOS Safari only

generateFacebook(5);
// 5 Android Facebook WebView strings

Chrome/Safari never mix with Facebook. Android Chrome is reduced (Android 10; K, Chrome/{major}.0.0.0). Facebook uses a real device model and FBAV.

CLI

bunx ua-gen --android 5 --ios 5
bunx ua-gen --facebook 5
bunx ua-gen --json --android 1

Maintainers

bun run update   # fetch Chrome / iOS / Facebook into src/snapshot.json
bun test
bun publish