ua-parser-js README

The project's README from github.com/faisalman/ua-parser-js. As one markdown file: README.md.

UAParser.js

UAParser.js UAParser.js UAParser.js

UAParser.js

Powerful User-Agent detection in a compact, ES5-friendly, dependency-free JavaScript library.

Demo

Documentation

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:

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:

OpenCollective GitHub Sponsors PayPal WeChat/Alipay

ua-parser-js (faisalman/ua-parser-js)

Searching Database…

Что это такое?UAParser.js — это компактная JavaScript-библиотека без зависимостей, которая разбирает строки user-agent и определяет браузеры, операционные системы, устройства, процессоры, движки рендеринга, ботов и ИИ-краулеров.
Это библиотека, которую я встраиваю в свой код, или облачный сервис, к которому я обращаюсь?Это библиотека, которую вы встраиваете в свой JavaScript-код: она ставится через npm или скачивается напрямую и работает в браузере или на сервере. Если не хотите ничего устанавливать, есть ещё управляемый REST API на основе того же парсера.
Как добавить её в свой проект?Установите npm-пакет или скачайте файл напрямую, затем используйте её в браузере, Node.js или другой современной JS-среде. Определения типов для TypeScript идут в комплекте, так что для старта больше ничего не нужно.
Кроме JavaScript мне что-нибудь ещё нужно для работы?Нет. Это код, совместимый с ES5, без требований к сборке; он работает в браузерах, Node.js и других современных JavaScript-средах на любой версии Node.
Чего в бесплатной версии нет по сравнению с PRO-версиями?В бесплатных версиях основные определения (браузер, CPU, устройство, движок, ОС) помечены предупреждением, а определение ботов и ИИ-краулеров, поддержка client hints и повышенная точность недоступны — всё это только в платных PRO-версиях.
Могу ли я использовать бесплатную версию в коммерческом проекте?Да: v1.x распространяется под MIT, а v2.x — под AGPL-3.0, и обе открытые версии допускают коммерческое использование. AGPL — copyleft-лицензия, поэтому для команд, которым нужна разрешительная лицензия без открытых обязательств, существуют платные PRO-версии ($14–$599).
Что конкретно она умеет определять?В бесплатных версиях — браузеры, процессоры, устройства, движки рендеринга и операционные системы. Платные PRO-версии добавляют определение ботов и ИИ-краулеров, дополнительные цели вроде приложений, почтовых клиентов и медиаплееров, а также поддержку client hints и повышенную точность.
У меня v0.7 или v1.x — переход на v2 пройдёт безболезненно?Не автоматически: в README сказано сначала прочитать CHANGELOG, потому что в v2 есть критические изменения, к тому же бесплатная лицензия меняется с MIT на AGPL.
Она работает с ES-модулями и TypeScript?Определения типов для TypeScript есть в каждой версии. Согласно таблице сравнения, поддержка ESM появилась в v2.x под AGPL и в PRO-версиях, а линейка v1.x работает только с CommonJS.
Насколько актуальная база данных для определения устройств?Она опирается на активно поддерживаемую обширную базу данных, которую называют проверенной в бою в крупных масштабах и которой доверяют ведущие технологические компании.
What are similar projects?core-js, lodash, turndown, validator.js, lollipop-css, ky, marked, cheerio
Creator
faisalman
Size
20.9 MB
Stars
10.2K
Age
14y
Commits · 90 Days