npm · #1498 most downloaded on npm

ua-parser-js

2.0.10134M downloads/mofaisalman/ua-parser-js ↗New releases in your daily digest, changelog included.

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

Last release 4 months ago
21 May 2026
Ships fairly regularly
a new release about every 5 weeks
Most releases are documented
notes for 23 of 29 stable releases
65 versions withdrawn
withdrawn after publishing
14 years old
94 releases · first in 2012

Release timeline

94 releases since 2012

2012201420162018

Releases

2.0.1021 May 2026Security2 sources agree
Fix ReDoS vulnerability by limiting Client Hints input length (GHSA-9h5v-pfqq-x599)
Version 2.0.10

Fix ReDoS vulnerability by limiting Client Hints input length (GHSA-9h5v-pfqq-x599)

Add new method useExtension() in UAParser to extend custom detection rules

Add new device vendor: Blackview, Coolpad, CUBOT, T-Mobile

Improve browser detection: Huawei Browser, UCBrowser

Improve OS detection: iOS

Identify WebView user-agent as inapp browser

extensions submodule:

Add new crawler: atlassian-bot, Audisto Crawler, AwarioBot, AwarioRssBot, AwarioSmartBot, BrightEdge Crawler, HubSpot Crawler, Meta-ExternalAds, Meta-WebIndexer, proximic, yacybot

Add new fetcher: Feedly, GoogleDocs, UptimeBot, virustotal

Add new library: phpcrawl

helpers submodule:

Fix isElectron() function return itself

What's Changed

Add Headline ev-crawler detection by @Carel155 in https://github.com/faisalman/ua-parser-js/pull/807

[extensions] Add new crawlers: Meta-WebIndexer, Meta-ExternalAds by @23tux in https://github.com/faisalman/ua-parser-js/pull/824

Fix: remove desktop from enums according to documentation by @mksotto in https://github.com/faisalman/ua-parser-js/pull/808

Add sideEffects=false to package.json by @denisx in https://github.com/faisalman/ua-parser-js/pull/781

New Contributors

@Carel155 made their first contribution in https://github.com/faisalman/ua-parser-js/pull/807

@23tux made their first contribution in https://github.com/faisalman/ua-parser-js/pull/824

@mksotto made their first contribution in https://github.com/faisalman/ua-parser-js/pull/808

@denisx made their first contribution in https://github.com/faisalman/ua-parser-js/pull/781

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.9...2.0.10

One column per quarter.

Additional notes

Version 2.0.10

Fix ReDoS vulnerability by limiting Client Hints input length (GHSA-9h5v-pfqq-x599)
Add new method useExtension() in UAParser to extend custom detection rules
Add new device vendor: Blackview, Coolpad, CUBOT, T-Mobile
Improve browser detection: Huawei Browser, UCBrowser
Improve OS detection: iOS
Identify WebView user-agent as inapp browser
extensions submodule:
- Add new crawler: atlassian-bot, Audisto Crawler, AwarioBot, AwarioRssBot, AwarioSmartBot, BrightEdge Crawler, HubSpot Crawler, Meta-ExternalAds, Meta-WebIndexer, proximic, yacybot
- Add new fetcher: Feedly, GoogleDocs, UptimeBot, virustotal
- Add new library: phpcrawl
helpers submodule:
- Fix isElectron() function return itself

What's Changed

Add Headline ev-crawler detection by @Carel155 in #807
[extensions] Add new crawlers: Meta-WebIndexer, Meta-ExternalAds by @23tux in #824
Fix: remove desktop from enums according to documentation by @mksotto in #808
Add sideEffects=false to package.json by @denisx in #781

New Contributors

@Carel155 made their first contribution in #807
@23tux made their first contribution in #824
@mksotto made their first contribution in #808
@denisx made their first contribution in #781

Full Changelog: 2.0.9...2.0.10

Open source →

2.0.93 Feb 20262 sources agree

Add new browser: Aloha Browser, Avira Secure Browser, Lighthouse, Luakit, Norton Private Browser

Version 2.0.9

Restore icons directory
Add new browser: Aloha Browser, Avira Secure Browser, Lighthouse, Luakit, Norton Private Browser
Add new OS: Vega OS
Improve OS detection: watchOS
extensions submodule:
- Add new crawler: atlassian-bot, Cloudflare-AutoRAG, Google-NotebookLM, SemrushBot-SWA
- Add new fetcher: FlipboardProxy

What's Changed

Add icons directory to package files by @Pek5892 in https://github.com/faisalman/ua-parser-js/pull/823

New Contributors

@Pek5892 made their first contribution in https://github.com/faisalman/ua-parser-js/pull/823

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.8...2.0.9

Open source →

Additional notes

Version 2.0.9

Restore icons directory
Add new browser: Aloha Browser, Avira Secure Browser, Lighthouse, Luakit, Norton Private Browser
Add new OS: Vega OS
Improve OS detection: watchOS
extensions submodule:
- Add new crawler: atlassian-bot, Cloudflare-AutoRAG, Google-NotebookLM, SemrushBot-SWA
- Add new fetcher: FlipboardProxy

What's Changed

Add icons directory to package files by @Pek5892 in #823

New Contributors

@Pek5892 made their first contribution in #823

Full Changelog: 2.0.8...2.0.9

Open source →

2.0.813 Jan 20262 sources agree

Resolve syntax error related to import renaming in ESM build

Version 2.0.8

Resolve syntax error related to import renaming in ESM build
Add new browser: HiBrowser, Opera Neon
Add new engine: Dillo
Improve browser detection: Brave, TikTok
Improve device detection: OnePlus
Improve OS detection: Firefox OS
extensions submodule:
- Add new CLI: PowerShell
- Add new email: Alpine, Android, AquaMail, Balsa, Barca, Canary, Claws Mail, eM Client, Eudora, FairEmail, Geary, Gnus, Horde::IMP, Lotus-Notes, IncrediMail, K-9 Mail, Mailbird, MailMate, Mailspring, Mutt, Newton, Nine, NylasMail, Outlook-Express, Pegasus Mail, PocoMail, Postbox, ProtonMail Bridge, Quala, R2Mail2, Rainloop, Roundcube Webmail, SamsungEmail, Spicebird, SquirrelMail, Sylpheed, The Bat!, Trojita, Turnpike, tutanota-desktop, Wanderlust, Windows-Live-Mail
- Add new library: http.rb, Jetty, ocaml-cohttp
helpers submodule:
- Add new method: getOutlookEdition() to map Outlook versions to their marketing editions

What's Changed

Improve existing browser detection for Tiktok by @giantyo26 in https://github.com/faisalman/ua-parser-js/pull/817
feat(email): expand email client detection & add Outlook edition helper by @cougrimes in https://github.com/faisalman/ua-parser-js/pull/819
chore: update pattern to ONLY include top-level js files in dist by @hyperz111 in https://github.com/faisalman/ua-parser-js/pull/820

New Contributors

@giantyo26 made their first contribution in https://github.com/faisalman/ua-parser-js/pull/817
@cougrimes made their first contribution in https://github.com/faisalman/ua-parser-js/pull/819
@hyperz111 made their first contribution in https://github.com/faisalman/ua-parser-js/pull/820

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.7...2.0.8

Open source →

Additional notes

Version 2.0.8

Resolve syntax error related to import renaming in ESM build
Add new browser: HiBrowser, Opera Neon
Add new engine: Dillo
Improve browser detection: Brave, TikTok
Improve device detection: OnePlus
Improve OS detection: Firefox OS
extensions submodule:
- Add new CLI: PowerShell
- Add new email: Alpine, Android, AquaMail, Balsa, Barca, Canary, Claws Mail, eM Client, Eudora, FairEmail, Geary, Gnus, Horde::IMP, Lotus-Notes, IncrediMail, K-9 Mail, Mailbird, MailMate, Mailspring, Mutt, Newton, Nine, NylasMail, Outlook-Express, Pegasus Mail, PocoMail, Postbox, ProtonMail Bridge, Quala, R2Mail2, Rainloop, Roundcube Webmail, SamsungEmail, Spicebird, SquirrelMail, Sylpheed, The Bat!, Trojita, Turnpike, tutanota-desktop, Wanderlust, Windows-Live-Mail
- Add new library: http.rb, Jetty, ocaml-cohttp
helpers submodule:
- Add new method: getOutlookEdition() to map Outlook versions to their marketing editions

What's Changed

Improve existing browser detection for Tiktok by @giantyo26 in #817
feat(email): expand email client detection & add Outlook edition helper by @cougrimes in #819
chore: update pattern to ONLY include top-level js files in dist by @hyperz111 in #820

New Contributors

@giantyo26 made their first contribution in #817
@cougrimes made their first contribution in #819
@hyperz111 made their first contribution in #820

Full Changelog: 2.0.7...2.0.8

Open source →

2.0.79 Dec 20252 sources agree

Add support for chaining withClientHints() & withFeatureCheck()

Version 2.0.7

Add support for chaining withClientHints() & withFeatureCheck()
Add new browser: Atlas, Steam
Add new device vendor: Anbernic, Logitech, Valve
Improve device detection: Xiaomi
Improve OS detection: iOS
Split helpers submodule into several new submodules:
- bot-detection:
  - isAIAssistant()
  - isAICrawler()
  - isBot()
- browser-detection
  - isChromeFamily()
  - isElectron()
  - isFromEU()
  - isStandalonePWA()
- device-detection
  - getDeviceVendor()
  - isAppleSilicon()
Update extensions submodule:
- Add new fetcher: Nova Act
- Add new library: Bun, Dart, Deno, hackney, Node.js, rest-client, undici

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.6...2.0.7

Open source →

Additional notes

Version 2.0.7

Add support for chaining withClientHints() & withFeatureCheck()
Add new browser: Atlas, Steam
Add new device vendor: Anbernic, Logitech, Valve
Improve device detection: Xiaomi
Improve OS detection: iOS
Split helpers submodule into several new submodules:
- bot-detection:
  - isAIAssistant()
  - isAICrawler()
  - isBot()
- browser-detection
  - isChromeFamily()
  - isElectron()
  - isFromEU()
  - isStandalonePWA()
- device-detection
  - getDeviceVendor()
  - isAppleSilicon()
Update extensions submodule:
- Add new fetcher: Nova Act
- Add new library: Bun, Dart, Deno, hackney, Node.js, rest-client, undici

Full Changelog: 2.0.6...2.0.7

Open source →

2.0.610 Oct 20252 sources agree

Add new CLI feature: processing batch user-agent data from file and output as JSON

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

What's Changed

chore: Replace Undici by native Headers by @regseb in https://github.com/faisalman/ua-parser-js/pull/805

New Contributors

@regseb made their first contribution in https://github.com/faisalman/ua-parser-js/pull/805

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.5...2.0.6

Open source →

2.0.59 Sept 20252 sources agree

Fix parsing error on pages with modified Array prototypes

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

What's Changed

chore: move node-fetch to devDeps by @undefined-moe in https://github.com/faisalman/ua-parser-js/pull/784
Zalo Integration in UAParser by @suryaanshah in https://github.com/faisalman/ua-parser-js/pull/792
Fix #797: Iterate over brands as an array by @anulman in https://github.com/faisalman/ua-parser-js/pull/798

New Contributors

@undefined-moe made their first contribution in https://github.com/faisalman/ua-parser-js/pull/784
@suryaanshah made their first contribution in https://github.com/faisalman/ua-parser-js/pull/792
@anulman made their first contribution in https://github.com/faisalman/ua-parser-js/pull/798

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.4...2.0.5

Open source →

2.0.424 Jun 20252 sources agree

Add new browser: Edge WebView, Edge WebView2

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
enums submodule:
- Fix mistakenly placed BLU categorized as browser name instead of device vendor

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.3...2.0.4

Open source →

2.0.314 Mar 20252 sources agree

Add new browser: Dooble, Ecosia, LG Browser, Otter, qutebrowser, Surf

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

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.2...2.0.3

Open source →

2.0.29 Feb 2025

Fix TypeScript dependency issue

Version 2.0.2

Fix TypeScript dependency issue

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.1...2.0.2

Open source →

Additional notes

Fix TypeScript dependency issue

Open source →

2.0.14 Feb 20252 sources agree

Add new browser: Ladybird, Daum

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

What's Changed

Add missing 1.0.39 changes to CHANGELOG.md by @haraldreingruber-dedalus in https://github.com/faisalman/ua-parser-js/pull/766
feat: add TypeScript definitions for UAParser.js enums by @mikehuebner in https://github.com/faisalman/ua-parser-js/pull/772
Add Daum app user agent by @HyewonKkang in https://github.com/faisalman/ua-parser-js/pull/773

New Contributors

@haraldreingruber-dedalus made their first contribution in https://github.com/faisalman/ua-parser-js/pull/766
@mikehuebner made their first contribution in https://github.com/faisalman/ua-parser-js/pull/772
@HyewonKkang made their first contribution in https://github.com/faisalman/ua-parser-js/pull/773

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/2.0.0...2.0.1

Open source →

2.0.018 Nov 2024

We’re excited to share the release of Version 2.0! This update comes with significant improvements and new features compared to earlier versions. Than

🚀 Version 2.0 is here!

We’re excited to share the release of Version 2.0! This update comes with significant improvements and new features compared to earlier versions. Thank you for your support!

Open source →

Additional notes

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

Open source →

2.0.0-rc.313 Nov 2024pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)Breaking2 sources agree

Breaking change: rename module to library

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

Open source →

2.0.0-rc.28 Nov 2024pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)2 sources agree

Fix incorrect import path in ESM files

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

Open source →

2.0.0-rc.129 Oct 2024pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)2 sources agree

Fix Python Request mistakenly identified as Meta Quest

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: clis, crawlers, fetchers, and modules

Open source →

2.0.0-beta.37 Jun 2024pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)2 sources agree

AR/VR devices moved to new device type: xr

Version 2.0.0-beta.3

Breaking:
- AR/VR devices moved to new device type: xr
- New property in browser: type
- In ua-parser-js/extensions submodule, bots divided into crawler / fetcher
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

Open source →

2.0.0-beta.21 Feb 2024pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)2 sources agree

Add TypeScript declaration file in ua-parser-js/extensions submodule

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

Open source →

2.0.0-beta.15 Oct 2023pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)

Update Client Hints Form-Factor

v2.0.0-beta.1

Update Client Hints Form-Factor
Add in-package type definitions

Open source →

Additional notes

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

Open source →

2.0.0-alpha.317 Aug 2023pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)2 sources agree

Add isFrozenUA() method in ua-parser-js/helpers submodule

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

Open source →

2.0.0-alpha.23 Apr 2023pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)2 sources agree

Fix browser result always returning Chromium when using withClientHints()

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 2.0

What's breaking:
- Browser detection on mobile device: "Chrome" => "Mobile Chrome", "Firefox" => "Mobile Firefox"
- OS detection: "Mac OS" => "macOS", "Chromium OS" => "Chrome OS"
What's new:
- Add some new methods in result object:
  - Add support for client hints: withClientHints()
  - Add support for feature detection: withFeatureCheck()
  - Utility for easy comparison: is()
  - Utility to print full-name: toString()
- Add support for ES module import { UAParser } from 'ua-parser-js'
- Provide Enums 'ua-parser-js/enums'
- Provide Extensions 'ua-parser-js/extensions'

Open source →

2.0.0-alpha.129 Mar 2023pre-releasewithdrawn: You are using an early pre-release version of ua-parser-js v2.x which may be unstable. Please update to the latest stable ua-parser-js v2.x release (https://uaparser.dev)

Initial work on new major version

Initial work on new major version

Open source →

1.0.4119 Aug 20252 sources agree

Add new browser: Daum, Ladybird

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

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/1.0.40...1.0.41

Open source →

1.0.4021 Dec 2024

Add new browser: 115, LibreWolf, Slimboat, Slimjet

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

Open source →

1.0.3914 Sept 2024

Add new feature: executable command using npx ua-parser-js "[INSERT-UA-HERE]"

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

Open source →

1.0.3828 May 20242 sources agree

Fix error on getOS() when userAgentData.platform is undefined

Version 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

Open source →

1.0.3727 Oct 2023

Fix misidentified WebView token as device model

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

Open source →

1.0.369 Sept 2023

Add new devices: Infinix, Tecno

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

Open source →

1.0.351 Apr 2023

Fix result of user-supplied user-agent from being altered

Version 0.7.35 / 1.0.35

Fix result of user-supplied user-agent from being altered (5b8adfef7b77494ae73199b7ee3e5dafba46e0a8)
Add new browser: Heytap, TikTok (3f8b5ba9cf03c2e82dcf96fd91a89c1b314dee3c, 2e06a34062c196322df7ad3c63fcc66e51c72420)
Add new engine: LibWeb (bf9ac43328f1d5235cd6e029ac505824a39fc796)
Add new OS: SerenityOS (bf9ac43328f1d5235cd6e029ac505824a39fc796)
Improve browser detection: Yandex (1747707be680c70073bc0cb496ffaacda3314f2b)
Improve device detection: iPhone, Amazon Echo (d41404551f1a6d2ae789f2a2c26b89b3f1f71610, ba067bd351040a57957a4f0965816897e0e3ddef)
Improve OS detection: iOS (d41404551f1a6d2ae789f2a2c26b89b3f1f71610)
See more...

Open source →

Additional notes

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

Open source →

1.0.345 Mar 2023

Fix Sharp Mobile detected as Huawei Tablet

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

Open source →

1.0.3322 Jan 2023

Identify Macintosh as an Apple device

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

Open source →

1.0.3215 Oct 2022withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Add new browser : DuckDuckGo, Huawei Browser, LinkedIn

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

Open source →

1.0.227 Oct 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Fix OPPO Reno A5 incorrect detection

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

Open source →

1.0.122 Oct 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Add new browser : Obigo, UP.Browser, Klar

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

Open source →

0.8.122 Oct 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later)

Nothing published for this version

0.7.4119 Aug 2025

Add new browser: Daum, Ladybird

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

Full Changelog: https://github.com/faisalman/ua-parser-js/compare/0.7.40...0.7.41

Open source →

0.7.4021 Dec 2024

Nothing published for this version

0.7.3911 Sept 2024

Nothing published for this version

0.7.3828 May 2024

Fix error on getOS() when userAgentData.platform is undefined

Version 0.7.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

Open source →

0.7.3727 Oct 2023

Fix misidentified WebView token as device model

Version 0.7.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

Open source →

0.7.369 Sept 2023

Nothing published for this version

0.7.351 Apr 2023

Nothing published for this version

0.7.345 Mar 2023

Nothing published for this version

0.7.3322 Jan 2023

Nothing published for this version

0.7.3215 Oct 2022withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.3127 Oct 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.3022 Oct 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2810 Apr 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.272 Apr 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2627 Mar 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2524 Mar 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2412 Feb 2021withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2310 Dec 2020withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2212 Sept 2020withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.2119 Dec 2019withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.208 Jun 2019withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.1925 Oct 2018withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.184 May 2018withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.1712 Oct 2017withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.1612 Oct 2017withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.1512 Oct 2017withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

0.7.1419 Jul 2017withdrawn: You are using an outdated version of ua-parser-js. Please update to ua-parser-js v0.7.33 / v1.0.33 / v2.0.0 (or later) to avoid ReDoS vulnerability [CVE-2022-25927](https://github.com/advisories/GHSA-fhg7-m89q-25r3)

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →