faisalman/ua-parser-js
Ua Parser Js
ua-parser-js is a JavaScript library used to extract browser, operating system, and device information from raw user agent strings and client hints. It functions as a cross-platform tool that runs in both web browsers and Node.js server environments to identify web visitors.
The library integrates modern HTTP client hint headers to retrieve hardware and browser details with higher accuracy than standard string parsing. It also includes a specialized detector to identify automated AI agents, web crawlers, and bots to distinguish human traffic from automated scripts.
The project covers hardware identification for vendors and device types, detection of specific client applications, and the identification of operating systems. It provides a command-line interface for processing individual strings or batch files into structured JSON visitor data.
Features
- User Agent Detection Libraries - Extracts browser, operating system, device, and bot information from raw user agent strings to identify web visitors.
- Device and Hardware Identification - Detects specific hardware properties, vendors, and device types to optimize content for different physical capabilities.
- Bot Detection - Provides a specialized parser for identifying automated AI agents, web crawlers, and bots.
- Bot Detection Systems - Recognizes automated bots, AI agents, and web crawlers to distinguish human traffic from automated scripts.
- Regex Pattern Matchers - Identifies browsers and devices by matching user agent strings against a prioritized list of regular expression patterns.
- Client Hint Parsing - Retrieves device and browser information using modern header hints for more accurate detection than standard strings.
- Client Hint Integration - Retrieves hardware and browser details using modern HTTP header hints for higher detection accuracy.
- Device and OS Detectors - Provides a comprehensive toolset for mapping user agent strings to specific hardware vendors, operating systems, and mobile devices.
- HTTP Client Hint Extraction - Extracts precise device and browser metadata using modern HTTP client hint headers for higher accuracy.
- Hardware Property Detection - Detects device vendors, Apple Silicon properties, and AR/VR hardware types to determine physical device capabilities.
- Isomorphic JavaScript Libraries - Implements a universal JavaScript codebase that functions identically in web browsers and Node.js server environments.
- JavaScript Environments - Provides a universal JavaScript implementation that runs consistently in both web browsers and Node.js environments.
- Client Detection Rules - Provides a mechanism to extend detection capabilities by adding custom regular expressions for browser and bot identification.
- Hierarchical Detection Logic - Implements a cascading rule hierarchy to ensure the most specific client identification overrides general results.
- Modular Extension Systems - Allows developers to inject custom regular expressions to extend the detection of new or niche software.
- Client Application Identification - Detects specific apps, libraries, email clients, and media players embedded within the user agent string.
- Specialized Client Detection - Identifies specific client types such as AI assistants, AI crawlers, Electron environments, and standalone PWAs.
- Web Visitor Analytics - Processes visitor data on the client or server to understand the technology stack used by a user base.
- Utility Libraries - User-agent string parsing for environment detection.
- UA 识别 - Listed in the “UA 识别” section of the Awesome Frontend awesome list.
