Package detail

ua-parser-js

faisalman75.5mAGPL-3.0-or-later2.0.6

Detect Browser, Engine, OS, CPU, and Device type/model from User-Agent & Client Hints data. Supports browser & node.js environment

user-agent, client-hints, browser, engine

readme

Featured Sponsors

https://ref.wisprflow.ai/Rxj3n8H

https://uaparser.dev https://uaparser.dev https://uaparser.dev https://uaparser.dev

Discord invite

UAParser.js

The most comprehensive, compact, and up-to-date JavaScript library to detect user's browser, OS, CPU, and device type/model. Also detect bots, apps, and more. Runs seamlessly in the browser (client-side) or Node.js (server-side).

Demo

Documentation

Before upgrading from v0.7 / v1.0, please read CHANGELOG to see what's new & breaking.

Package & Pricing

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 📥

Development

Contributors

Please read CONTRIBUTING guide first for the instruction details.

Made with contributors-img.

Backers & Sponsors

Support the open-source editions of UAParser.js through one of the following options:

OpenCollective GitHub Sponsors PayPal WeChat/Alipay

changelog

UAParser.js Changelog

Migrating from v1 to v2

What's Breaking:

  • Licensing Changes:

    • UAParser.js is now licensed under AGPLv3 for open-source use, with PRO Licenses available for commercial/proprietary use

  • Browser Detection on Mobile Devices:

    • "Chrome" => "Mobile Chrome"
    • "Firefox" => "Mobile Firefox"

  • OS Detection:

    • "Mac OS" => "macOS"
    • "Chromium OS" => "Chrome OS"

What's New:

  • Support for ES Modules & TypeScript:

    • Import directly as an ES module with TypeScript support: import { UAParser } from 'ua-parser-js'

  • Support for Custom/Predefined Extensions:

    • Pass custom regexes or predefined extensions as a list to UAParser()

  • Support for CLI Processing:

    • Directly parse user-agent strings from the command line: npx ua-parser-js "<User-Agent>"
    • Process batch data from files: npx ua-parser-js --input-file=log.txt >> result.json or npx ua-parser-js --input-file=log.txt --output-file=result.json

  • Enhanced Detection with Client Hints:

    • withClientHints(): Improves detection accuracy by leveraging client hints

  • Enhanced Detection with Feature Detection:

    • withFeatureCheck(): Refines detection results using feature detection

  • Simple Comparison for Detection Results:

    • is(): Enables easy comparison checks against the detection result

  • Detailed Result Output:

    • toString(): Returns the detection result in form of a full-name string

  • New Device Type:

    • Added xr to identify AR/VR devices

  • New Browser Property:

    • Added browser.type to identify additional browser types:
      • crawler, cli, email, fetcher, inapp, library, mediaplayer

  • New Submodules:

    • 'ua-parser-js/enums': Provides constants for these specific properties:

      • browser.name, browser.type, cpu.architecture, device.type, device.vendor, engine.name, os.name

    • 'ua-parser-js/extensions': Predefined extensions for various use cases:

      • Bots, Crawlers, CLIs, Emails, ExtraDevices, Fetchers, InApps, Libraries, Mediaplayers

    • 'ua-parser-js/helpers': Provides utility methods to extend detection functionality:

      • getDeviceVendor(): Guesses the device vendor based on its model name
      • isAppleSilicon(): Detects Apple Silicon device properties
      • isAIBot(): Checks if the user-agent is an AI bot
      • isBot(): Checks if the user-agent is a bot
      • isChromeFamily(): Checks if the browser is Chrome-based (uses Blink engine) — e.g., New Opera, New Edge, Vivaldi, Brave, Arc, etc.
      • isElectron(): Detects if current window is running within Electron
      • isFromEU(): Detects if current browser's timezone is from an EU country
      • isFrozenUA(): Checks if the user-agent matches a frozen/reduced user-agent pattern
      • isStandalonePWA(): Detects if current window is a standalone PWA

Version 2.0.6

  • Add new CLI feature: processing batch user-agent data from file and output as JSON
  • Fix setUA(): trim leading space from user-agent string input
  • Replace undici dependency with node's internal Headers
  • Add new browser: Bing, Qwant
  • Add new device vendor: Hisense, Wiko
  • Improve browser detection: Mozilla, Pale Moon
  • Improve CPU detection: 68k
  • Improve device detection: Apple, BlackBerry, Huawei, Nokia, Xiaomi
  • Improve OS detection: iOS 26
  • extensions submodule:
    • Add new fetcher: Discordbot, KeybaseBot, Slackbot, Slackbot-LinkExpanding, Slack-ImgProxy, Twitterbot
    • Add new crawler: Qwantbot-news, SurdotlyBot, SwiftBot

Version 2.0.5

  • Add new browser: Zalo
  • Add new CPU arch: alpha
  • Add new device vendor: Philips
  • Improve device detection: Pico
  • Fix parsing error on pages with modified Array prototypes
  • Improve type declarations:
    • Replace node-fetch dependency with undici
    • Replace hardcoded string values with enum from enum submodule
  • enums submodule:
    • Add Extension enum for extensions submodule
    • Type declaration file now automatically generated using build script
    • Naming adjustments:
      • Browser => BrowserName
      • CPU => CPUArch
      • Device => DeviceType
      • Vendor => DeviceVendor
      • Engine => EngineName
      • OS => OSName
  • extensions submodule:
    • Add new crawlers: APIs-Google, Algolia Crawler, Algolia Crawler Renderscript, Baidu-ADS, BLEXBot, botify, Bravebot, Claude-Web, cohere-training-data-crawler, contxbot, Cotoyogi, Coveobot, CriteoBot, DeepSeekBot, DuckDuckGo-Favicons-Bot, Elastic, FirecrawlAgent, Freespoke, Google-CloudVertexBot, HuggingFace-Bot, Kagibot, Kangaroo Bot, marginalia, msnbot, OnCrawl, Replicate-Bot, RunPod-Bot, SBIntuitionsBot, SeekportBot, Siteimprove, Sogou Pic Spider, TikTokSpider, TwinAgent, v0bot, webzio, Webzio-Extended, xAI-Bot, YandexAccessibilityBot, YandexAdditionalBot, YandexAdNet, YandexBot MirrorDetector, YandexBlogs, YandexComBot, YandexFavicons, YandexImageResizer, YandexImages, YandexMarket, YandexMetrika, YandexMedia, YandexMobileBot, YandexMobileScreenShotBot, YandexNews, YandexOntoDB, YandexOntoDBAPI, YandexPartner, YandexRCA, YandexRenderResourcesBot, YandexScreenshotBot, YandexSpravBot, YandexTracker, YandexVertis, YandexVerticals, YandexVideo, YandexVideoParser, YandexWebmaster, YepBot, ZumBot
    • Add new fetchers: Asana, bitlybot, Blueno, BufferLinkPreviewBot, Chrome-Lighthouse, Gemini-Deep-Research, HubSpot Page Fetcher, kakaotalk-scrap, vercel-favicon-bot, vercel-screenshot-bot, vercelflags, verceltracing, YaDirectFetcher, YandexCalendar, YandexDirect, YandexDirectDyn, YandexForDomain, YandexPagechecker, YandexSearchShop, YandexSitelinks, YandexUserproxy
  • helpers submodule:
    • Add some crawler to isAIBot(): Bravebot, cohere-training-data-crawler, FirecrawlAgent, HuggingFace-Bot, Kangaroo Bot, PanguBot, Replicate-Bot, RunPod-Bot, TikTokSpider, Together-Bot, v0bot, xAI-Bot

Version 2.0.4

  • Add new browser: Edge WebView, Edge WebView2
  • Add new device vendor: Lava, Retroid, Vizio
  • Add new OS: ArcaOS, Knoppix, Xubuntu, Windows CE, Windows RT
  • Improve device detection: Google Pixel & Pixelbook Series, HMD, Infinix, LG WebOS TV, Motorola, Nothing, OnePlus, Sony, Tecno
  • Improve OS detection: AIX, Arch, Fuchsia, Haiku, HarmonyOS, Mint, MorphOS, Solaris, Windows
  • Improve withClientHints() browser naming adjustments: Microsoft Edge WebView2 => Edge WebView2
  • Identify device that uses Firefox Reality / Wolvic as xr
  • Identify device with large screen as smarttv
  • Identify Windows CE & Windows RT as distinct OS variants
  • extensions submodule:
    • Remove lookbehind assertion to ensure regex compatibility
    • Add new crawlers: ChatGLM, Daum, iAskBot, Onespot, Qwantbot, Startpage
    • Add new emails: Apple's Mail, DaumMail, Polymail, ProtonMail, SparkDesktop, Zimbra, ZohoMail-Desktop
    • Add new fetchers: Iframely, MistralAI-User, Perplexity-User
    • Add new inApps: Discord, Evernote, Figma, Flipboard, Mattermost, Notion, Postman, Rambox, Rocket.Chat, Microsoft Teams, TikTok Lite, VS Code
    • Add new libraries: AdobeAIR, aiohttp, nutch, httpx, urllib3
  • enum submodule:
    • Fix mistakenly placed BLU categorized as browser name instead of device vendor

Version 2.0.3

  • Add new browser: Dooble, Ecosia, LG Browser, Otter, qutebrowser, Surf
  • Add new device: BLU, Facebook Portal TV
  • Improve device detection: Archos, LG, Meta Quest
  • Remove jazzer.js fuzz test
  • Improve withClientHints():
    • Browser naming adjustments:
      • HuaweiBrowser => Huawei Browser
      • Miui Browser => MIUI Browser
      • OperaMobile => Opera Mobi
      • YaBrowser => Yandex
  • extensions submodule:
    • Add new Crawler: AdIdxBot, Linespider, LinkedInBot, OpenAI Image Downloader, SemrushBot, Yahoo! Slurp
    • Add new Fetcher: Better Uptime Bot, Google-PageRenderer, GoogleImageProxy, MicrosoftPreview, Snap URL Preview, SkypeUriPreview, TelegramBot
    • Add new Vehicles: BMW, Jeep
    • Add OS detection of WhatsApp user-agent

Version 2.0.2

  • Fix TypeScript dependency issue

Version 2.0.1

  • Add new browser: Ladybird, Daum
  • Add new device: Apple HomePod
  • Add new device vendor: HMD
  • Add new OS: Ubuntu Touch, Windows IoT
  • Improve CPU detection: ARM, x86
  • Improve device detection: Lenovo, Nokia, Nvidia, Xiaomi
    • Tablet: Google, Honor, Huawei, Infinix, Nokia, OnePlus, Xiaomi
    • Wearable: Asus, Google, LG, Motorola, OnePlus, Oppo, Samsung, Sony
    • Smart-TV: Xiaomi, unidentified vendors
    • Improve detection for unknown VR devices
    • Improve device model detection for Generic devices
  • Improve OS detection: Linux, Symbian
  • Improve TypeScript definitions for Headers
  • Improve withClientHints():
    • engine.version also get updated
    • Infer device.vendor & device.type by guessing from device.model
    • Browser naming adjustments:
      • Google Chrome => Chrome
      • Microsoft Edge => Edge
      • Android WebView => Chrome WebView
      • HeadlessChrome => Chrome Headless
  • enums submodule:
    • Add TypeScript definitions
  • extensions submodule:
    • Add new list:
      • Vehicles: BYD, Rivian, Volvo
    • Add new Fetcher: Bluesky
    • Add new Library: Apache-HttpClient, go-http-client, got, GuzzleHttp, Java-http-client, libwww-perl, lua-resty-http, Needle, OkHttp, node-fetch, PHP-SOAP, PostmanRuntime, superagent

Version 2.0.0

  • ua-parser-js/extensions submodule:
    • Add new CLI: ELinks, HTTPie
    • Add new crawler: AI2Bot, aiHitBot, anthropic-ai, Diffbot, ImagesiftBot, magpie-crawler, Omgilibot, Screaming Frog SEO Spider, Seznambot, Teoma, Timpibot, VelenPublicWebCrawler, Webzio-Extended, YouBot
    • Add new email: Airmail, BlueMail, eMClient, NaverMailApp, Sparrow, Yahoo
    • Add new fetcher: cohere-ai, Vercelbot
    • Add new library: java, python-urllib, python-requests
  • ua-parser-js/helpers submodule:
    • Add new method isAIBot(): Checks if the user-agent is an AI bot

Version 2.0.0-rc.3

  • Add support for Headers object
  • Add new device: Advan, Cat, Energizer, Honor, IMO, Micromax, Smartfren
  • Add new engine: Servo
  • ua-parser-js/extensions submodule:
    • Breaking change: rename module to library
    • Add new email clients: Evolution, KMail, Kontact
    • Add new bots: 360Spider, Archive.org Bots, CCBot, DataForSeoBot, DuckAssistBot, Exabot, Google Bots, Meta Bots, MojeekBot, PerplexityBot, PetalBot, TurnitinBot, Yeti, YisouSpider

Version 2.0.0-rc.2

  • Fix incorrect import path in ESM files
  • Add new browser: 115, SlimBoat, Slimjet, LibreWolf
  • Improve browser detection: 2345, 360, Dragon, Iron, Maxthon
  • ua-parser-js/enums submodule:
    • Add Chromecast OS variants: Android/Fuchsia/Linux/SmartSpeaker
  • ua-parser-js/helpers submodule:
    • Add new method: isBot() to check if the browser is identified as a bot

Version 2.0.0-rc.1

  • Fix Python Request mistakenly identified as Meta Quest
  • Add new browser: Helio
  • Add new device: itel, Nothing, Pico, TCL
  • Add new engine: ArkWeb
  • Add new OS: OpenHarmony, Pico
  • Improve browser detection: Quark
  • Improve device detection: Xiaomi, Amazon Echo Show, Google Chromecast, Samsung Galaxy Watch
  • ua-parser-js/helpers submodule:
    • Add new method:
      • getDeviceVendor() to guess for a device vendor based on its model name
      • isElectron() to check if current window is running inside Electron
      • isFromEU() to check if current window is from an EU (European Union) country
      • isStandalonePWA() to check if current window is a standalone PWA
    • Rename isChromiumBased() to isChromeFamily()
    • Update isAppleSilicon() to also checks for WebGL renderer info
  • ua-parser-js/extensions submodule:
    • Restore Bots as a compilation of all these browser types: cli, crawler, fetcher, and library

Version 2.0.0-beta.3

  • Breaking:
    • AR/VR devices moved to new device type: xr
    • New property in browser: type
  • New features:
    • Parse directly from command line using npx ua-parser-js
    • Extensions can be passed as a list to UAParser()
  • Add new browser: Pico Browser, Twitter, Wolvic
  • Improve browser detection: DuckDuckGo, ICEBrowser, Klar, QQ, Sleipnir
  • Improve device detection: Oculus Quest & Oppo Pad
  • Update latest client hints spec: formFactor -> formFactors
  • In ua-parser-js/extensions submodule, bots divided into crawler / fetcher

Version 2.0.0-beta.2

  • Increase UA_MAX_LENGTH to 500
  • Add TypeScript declaration file in ua-parser-js/extensions submodule
  • Improve TypeScript module resolution
  • Add new methods in ua-parser-js/helpers submodule: isAppleSilicon() & isChromiumBased()
  • Fix misidentified WebView token as device model
  • Add new browser: Alipay, Klarna, Opera GX, Smart Lenovo Browser, Vivo Browser
  • Rename browser: Avant, Baidu, Samsung Internet, Sogou Explorer, Sogou Mobile, WeChat
  • Improve client-hints detection: Edge, Xbox

Version 2.0.0-beta.1

  • Update Client Hints Form-Factor
  • Provide in-package type definitions
  • Add new device: Ulefone
  • Improve device detection: Realme, Xiaomi Redmi

Version 2.0.0-alpha.3

  • Add withFeatureCheck() method
  • Add isFrozenUA() method in ua-parser-js/helpers submodule
  • Add MediaPlayers & Modules in ua-parser-js/extensions submodule
  • Fix issue with ESM import

Version 2.0.0-alpha.2

  • Fix browser result always returning Chromium when using withClientHints()
  • Fix infinite-loop when await-ing withClientHints() in non-client-hints browser

Version 2.0.0-alpha.1

  • Initial work on new major version

Version 0.7.41 / 1.0.41

  • Add new browser: Daum, Ladybird
  • Add new device vendor: HMD
  • Add new engine: LibWeb
  • Add new os: Windows IoT, Ubuntu Touch
  • Improve cpu detection: ARM, x86
  • Improve device vendor detection: Apple, Archos, Generic, Google, Honor, Huawei, Infinix, Nvidia, Lenovo, Nokia, OnePlus, Xiaomi
  • Improve device type detection: smarttv, wearables
  • Improve os detection: Linux, Symbian

Version 0.7.40 / 1.0.40

  • Add new browser: 115, LibreWolf, Slimboat, Slimjet
  • Add new device: Advan, Cat, Energizer, IMO, Micromax, Smartfren
  • Add new engine: ArkWeb, Servo
  • Add new os: OpenHarmony
  • Improve browser detection: 2345, 360, Dragon, Iron, Maxthon
  • Recognize Honor as a separate device vendor from Huawei
  • Fix Python Request mistakenly identified as Meta Quest

Version 0.7.39 / 1.0.39

  • Add new feature: executable command using npx ua-parser-js "[INSERT-UA-HERE]"
  • Add new browser: Helio, Pico Browser, Wolvic
  • Add new device vendor: itel, Nothing, TCL
  • Improve browser detection: ICEBrowser, Klar, QQBrowser, Quark, Rekonq, Sleipnir
  • Improve device detection: Xiaomi Pro, Amazon Echo Show, Samsung Galaxy Watch
  • Removed from browser: Viera

Version 0.7.38 / 1.0.38

  • Fix error on getOS() when userAgentData.platform is undefined
  • Add new browser: Opera GX, Twitter
  • Improve browser detection: DuckDuckGo
  • Improve device detection: OPPO Pad, Oculus Quest

Version 0.7.37 / 1.0.37

  • Fix misidentified WebView token as device model
  • Increase UA_MAX_LENGTH to 500
  • Add new browser: Alipay, Klarna, Smart Lenovo Browser, Vivo Browser
  • Add new device: Ulefone
  • Improve device detection: Realme, Xiaomi Redmi
  • Rename browser: Avant, Baidu, Samsung Internet, Sogou Explorer, Sogou Mobile, WeChat

Version 0.7.36 / 1.0.36

  • Add new browser: Snapchat
  • Add new devices: Infinix, Tecno
  • Improve device detection: Amazon Fire TV, Xiaomi POCO
  • Improve OS detection: iOS

Version 0.7.35 / 1.0.35

  • Fix result from user-supplied user-agent being altered
  • Add new browser: Heytap, TikTok
  • Add new engine: LibWeb
  • Add new OS: SerenityOS
  • Improve browser detection: Yandex
  • Improve device detection: iPhone, Amazon Echo
  • Improve OS detection: iOS

Version 0.7.34 / 1.0.34

  • Fix Sharp Mobile detected as Huawei Tablet
  • Fix IE8 bug
  • Add new devices : Kobo e-Reader, Apple Watch, and some new SmartTV devices
  • Add new OS : watchOS
  • Improve browser detection : Kakao, Naver, Brave
  • Improve device detection : Oculus, iPad
  • Improve OS detection : Chrome OS
  • Using navigator.userAgentData as fallback for device.type & os.name

Version 0.7.33 / 1.0.33

  • Add new browser : Cobalt
  • Identify Macintosh as an Apple device
  • Fix ReDoS vulnerability

Version 0.7.32 / 1.0.32

  • Add new browser : DuckDuckGo, Huawei Browser, LinkedIn
  • Add new OS : HarmonyOS
  • Add some Huawei models
  • Add Sharp Aquos TV
  • Improve detection Xiaomi Mi CC9
  • Fix Sony Xperia 1 III misidentified as Acer tablet
  • Fix Detect Sony BRAVIA as SmartTV
  • Fix Detect Xiaomi Mi TV as SmartTV
  • Fix Detect Galaxy Tab S8 as tablet
  • Fix WeGame mistakenly identified as WeChat
  • Fix included commas in Safari / Mobile Safari version
  • Increase UA_MAX_LENGTH to 350

Version 0.7.31 / 1.0.2

  • Fix OPPO Reno A5 incorrect detection
  • Fix TypeError Bug
  • Use AST to extract regexes and verify them with safe-regex

Version 0.7.30 / 1.0.1

  • Add new browser : Obigo, UP.Browser, Klar
  • Add new device : Oculus, Roku
  • Add new OS: Maemo, HP-UX, Android-x86, Deepin, elementary OS, GhostBSD, Linspire, Manjaro, Sabayon
  • Improve detection for Sony Xperia 1ii, LG Android TV, and some more devices
  • Improve detection for ARM64 CPU
  • Improve detection for Windows Mobile, Netscape, Mac on PowerPC
  • Categorize PDA as mobile
  • Fix Sharp devices misjudged as Huawei
  • Fix trailing comma for ES3 compatibility
  • Some code refactor

Version 0.7 / 1.0

Version 1.0.x is basically the equivalent of version 0.7.x (mirror/duplicate). See #536 for the reason behind this confusion.

Version 0.8

Version 0.8 was created by accident. This version is now deprecated and no longer maintained, please update to version 0.7 / 1.0.