Technical Documentation: faisalman/ua-parser-js
ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference
Overview (`README.md`)
UAParser.js
Powerful User-Agent detection in a compact, ES5-friendly, dependency-free JavaScript library.
- ✅ Comprehensive detection: Identify various kind of browsers, OS, devices, bots, apps, AI crawlers, and more
- ✅ Battle-tested at scale: Backed by an actively maintained, extensive detection database, trusted by leading tech companies
- ✅ Runs everywhere: Use seamlessly in browsers, Node.js, and modern JavaScript runtimes
Demo
- Live demo: https://uaparser.dev
Documentation
version 1.x: https://docs.uaparser.dev/v1version 2.x: https://docs.uaparser.dev
Before upgrading from v0.7 / v1.0, please read CHANGELOG to see what's new & breaking.
Package Options
| Open-Source Editions | PRO / Commercial Editions | ||||
|---|---|---|---|---|---|
| License options | MIT (v1.x) | AGPL (v2.x) | PRO Personal | PRO Business | PRO Enterprise |
| Browser Detection | ⚠️ | ✅ | ✅ | ✅ | ✅ |
| CPU Detection | ⚠️ | ✅ | ✅ | ✅ | ✅ |
| Device Detection | ⚠️ | ✅ | ✅ | ✅ | ✅ |
| Rendering Engine Detection | ⚠️ | ✅ | ✅ | ✅ | ✅ |
| OS detection | ⚠️ | ✅ | ✅ | ✅ | ✅ |
| Enhanced+ Accuracy | ❌ | ✅ | ✅ | ✅ | ✅ |
| Bot Detection | ❌ | ✅ | ✅ | ✅ | ✅ |
| AI Detection | ❌ | ✅ | ✅ | ✅ | ✅ |
| Extra Detections (Apps, Libs, Emails, Media Players, Crawlers, and more) | ❌ | ✅ | ✅ | ✅ | ✅ |
| Client Hints Support | ❌ | ✅ | ✅ | ✅ | ✅ |
| CommonJS Support | ✅ | ✅ | ✅ | ✅ | ✅ |
| ESM Support | ❌ | ✅ | ✅ | ✅ | ✅ |
| TypeScript Definitions | ✅ | ✅ | ✅ | ✅ | ✅ |
| npm Module Available | ✅ | ✅ | ✅ | ✅ | ✅ |
| Direct Downloads Available | ✅ | ✅ | ✅ | ✅ | ✅ |
| Commercial Use Allowed | ✅ | ✅ | ❌ | ✅ | ✅ |
| Permissive (non-Copyleft) License | ✅ | ❌ | ✅ | ✅ | ✅ |
| No Open-Source Obligations | ✅ | ❌ | ✅ | ✅ | ✅ |
| Unlimited End-Products | ✅ | ✅ | ✅ | ❌ | ✅ |
| Unlimited Deployments | ✅ | ✅ | ✅ | ❌ | ✅ |
| 1-year Product Support | ❌ | ❌ | ✅ | ✅ | ✅ |
| Lifetime Updates | ✅ | ✅ | ✅ | ✅ | ✅ |
| Price | FREE* (License) | FREE* (License) | $14 (License) | $29 (License) | $599 (License) |
| GET THE PRO PACKAGES 📥 |
NEW: Managed REST API
Skip the installation, use the User-Agent API in any application:
- ✅ Works everywhere: Integrate with JavaScript, Python, PHP, Java, or any HTTP client
- ✅ Production-ready: Powered by UAParser.js and continuously updated
- ✅ Zero maintenance: We manage the packages, parser updates, device data, and infrastructure for you
Learn more and start building at uaparser.dev/#rest-api
Development
Contributors
This project wouldn't be possible without all the amazing people in the open-source community. Thanks to everyone who contributed, reported issues, and shared feedback.
Made with contributors-img.
Contributions are welcome! Please read the CONTRIBUTING GUIDE first for detailed contribution instructions.
Backers & Sponsors
Support the open-source editions of UAParser.js through one of the following options:
--- METRICS ---
- Files Extracted: 1
- Estimated Token Budget: ~2489 tokens
- Canonical Reference: https://codewiki.google/github.com/faisalman/ua-parser-js