# browserslist-useragent-regexp > A utility to compile browserslist query to a RegExp to test browser useragent. Latest version **4.1.4** (published 2026-04-05) · MIT license · 0 weekly downloads ## Install ```sh npm install browserslist-useragent-regexp pnpm add browserslist-useragent-regexp yarn add browserslist-useragent-regexp bun add browserslist-useragent-regexp ``` Provides the commands `bluare`, `browserslist-useragent-regexp`. ## Health **Score 65/100 (B)** — status: active. Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score. Warnings: low downloads. ## Facts | | | |---|---| | Version | 4.1.4 | | Published | 2026-04-05 | | First published | 2019-04-01 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM | | Node | >=14.0.0 | | Dependencies | 5 | | Unpacked size | 192.6 KB | | Known vulnerabilities | 0 | | Install scripts | no | | Provenance | attested (GitHub Actions) | | GitHub stars | 273 | | Author | dangreen | | Maintainers | dangreen | | Keywords | browserslist, useragent, regexp | ## Links - npm: https://www.npmjs.com/package/browserslist-useragent-regexp - Repository: https://github.com/browserslist/browserslist-useragent-regexp - Homepage: https://github.com/browserslist/browserslist-useragent-regexp#readme - Issues: https://github.com/browserslist/browserslist-useragent-regexp/issues - Funding: https://ko-fi.com/dangreen - npm.io page: https://npm.io/package/browserslist-useragent-regexp ## Dependencies (5) - [argue-cli](https://npm.io/package/argue-cli.md) ^2.1.0 - [easy-table](https://npm.io/package/easy-table.md) ^1.2.0 - [picocolors](https://npm.io/package/picocolors.md) ^1.0.0 - [regexp-tree](https://npm.io/package/regexp-tree.md) ^0.1.24 - [ua-regexes-lite](https://npm.io/package/ua-regexes-lite.md) ^1.2.1 ## Alternatives - [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads - [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads - [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads - [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads - [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads ## Recent versions - 4.1.4 (latest) — 2026-04-05 - 4.1.3 — 2024-04-10 - 4.1.2 — 2024-04-05 - 4.1.1 — 2023-12-24 - 4.1.0 — 2023-06-16 - 4.0.0 — 2022-11-15 - 4.0.0-beta.1 — 2022-11-06 - 4.0.0-beta.0 — 2022-10-15 - 3.0.2 — 2021-10-01 - 3.0.1 — 2021-09-23 - 3.0.0 — 2021-02-03 - 2.1.1 — 2020-10-17 - 2.1.0 — 2020-06-10 - 2.0.5 — 2020-05-12 - 2.0.4 — 2020-04-23 - … 16 more at https://npm.io/package/browserslist-useragent-regexp/versions ## README # browserslist-useragent-regexp [![ESM-only package][package]][package-url] [![NPM version][npm]][npm-url] [![Node version][node]][node-url] [![Dependencies status][deps]][deps-url] [![Install size][size]][size-url] [![Build status][build]][build-url] [![Coverage status][coverage]][coverage-url] [![Documentation badge][documentation]][documentation-url] [package]: https://img.shields.io/badge/package-ESM--only-ffe536.svg [package-url]: https://nodejs.org/api/esm.html [npm]: https://img.shields.io/npm/v/browserslist-useragent-regexp.svg [npm-url]: https://npmjs.com/package/browserslist-useragent-regexp [node]: https://img.shields.io/node/v/browserslist-useragent-regexp.svg [node-url]: https://nodejs.org [deps]: https://img.shields.io/librariesio/release/npm/browserslist-useragent-regexp [deps-url]: https://libraries.io/npm/browserslist-useragent-regexp [size]: https://packagephobia.com/badge?p=browserslist-useragent-regexp [size-url]: https://packagephobia.com/result?p=browserslist-useragent-regexp [build]: https://img.shields.io/github/actions/workflow/status/browserslist/browserslist-useragent-regexp/tests.yml?branch=master [build-url]: https://github.com/browserslist/browserslist-useragent-regexp/actions [coverage]: https://img.shields.io/codecov/c/github/browserslist/browserslist-useragent-regexp.svg [coverage-url]: https://app.codecov.io/gh/browserslist/browserslist-useragent-regexp [documentation]: https://img.shields.io/badge/API-Documentation-2b7489.svg [documentation-url]: https://browserslist.github.io/browserslist-useragent-regexp A utility to compile [browserslist query](https://github.com/browserslist/browserslist#queries) to a regex to test browser useragent. Simplest example: you can detect supported browsers on client-side. 1) Create `.browserslistrc` config, for example like this: ``` last 2 versions not dead ``` 2) Add script to `package.json`: ```json { "scripts": { "supportedBrowsers": "echo \"export default $(browserslist-useragent-regexp --allowHigherVersions);\" > supportedBrowsers.js" } } ```
for Windows users ```json { "scripts": { "supportedBrowsers": "(echo export default && browserslist-useragent-regexp --allowHigherVersions) > supportedBrowsers.js" } } ```
3) Run this script, to compile regex: ```bash pnpm supportedBrowsers # or npm run supportedBrowsers # or yarn supportedBrowsers ``` `supportedBrowsers.js`: ```js export default /Edge?\/(10[5-9]|1[1-9]\d|[2-9]\d\d|\d{4,})(\.\d+|)(\.\d+|)|Firefox\/(10[4-9]|1[1-9]\d|[2-9]\d\d|\d{4,})\.\d+(\.\d+|)|Chrom(ium|e)\/(10[5-9]|1[1-9]\d|[2-9]\d\d|\d{4,})\.\d+(\.\d+|)|Maci.* Version\/(15\.([6-9]|\d{2,})|(1[6-9]|[2-9]\d|\d{3,})\.\d+)([,.]\d+|)( Mobile\/\w+|) Safari\/|Chrome.+OPR\/(9\d|\d{3,})\.\d+\.\d+|(CPU[ +]OS|iPhone[ +]OS|CPU[ +]iPhone|CPU IPhone OS|CPU iPad OS)[ +]+(15[._]([6-9]|\d{2,})|(1[6-9]|[2-9]\d|\d{3,})[._]\d+)([._]\d+|)|Opera Mini|Android:?[ /\-](10[6-9]|1[1-9]\d|[2-9]\d{2}|\d{4,})(\.\d+|)(\.\d+|)|Mobile Safari.+OPR\/(6[4-9]|[7-9]\d|\d{3,})\.\d+\.\d+|Android.+Firefox\/(10[5-9]|1[1-9]\d|[2-9]\d\d|\d{4,})\.\d+(\.\d+|)|Android.+Chrom(ium|e)\/(10[6-9]|1[1-9]\d|[2-9]\d\d|\d{4,})\.\d+(\.\d+|)|Android.+(UC? ?Browser|UCWEB|U3)[ /]?(13\.([4-9]|\d{2,})|(1[4-9]|[2-9]\d|\d{3,})\.\d+)\.\d+|SamsungBrowser\/(1[7-9]|[2-9]\d|\d{3,})\.\d+|Android.+MQQBrowser\/(13(\.([1-9]|\d{2,})|)|(1[4-9]|[2-9]\d|\d{3,})(\.\d+|))(\.\d+|)|K[Aa][Ii]OS\/(2\.([5-9]|\d{2,})|([3-9]|\d{2,})\.\d+)(\.\d+|)/; ``` 4) Import regex from created file: ```js import supportedBrowsers from './supportedBrowsers.js'; if (supportedBrowsers.test(navigator.userAgent)) { alert('Your browser is supported.'); } ``` ## Install ```bash pnpm add -D browserslist-useragent-regexp # or npm i -D browserslist-useragent-regexp # or yarn add -D browserslist-useragent-regexp ``` ## Why? As was written in article ["Smart Bundling: Shipping legacy code to only legacy browsers"](https://www.smashingmagazine.com/2018/10/smart-bundling-legacy-code-browsers/): you can determinate, which bundle you should give to browser from server with [`browserslist-useragent`](https://github.com/browserslist/browserslist-useragent). But in this case you must have your own server with special logic. Now, with `browserslist-useragent-regexp`, you can move that to client-side. Development was inspired by [this proposal from Mathias Bynens](https://twitter.com/mathias/status/1105857829393653761). How to make differential resource loading and other optimizations with `browserslist-useragent-regexp` you can read in article ["Speed up with Browserslist"](https://dev.to/dangreen/speed-up-with-browserslist-30lh). [Demo](https://browserslist.github.io/browserslist-useragent-regexp/demo.html) ([sources](https://github.com/browserslist/browserslist-useragent-regexp/blob/7cf6afb7da2b6c77179abb8b8bd1bbcb61cf376a/docs/demo.html#L17-L29), [build script](https://github.com/browserslist/browserslist-useragent-regexp/blob/7cf6afb7da2b6c77179abb8b8bd1bbcb61cf376a/examples/buildDemo.js#L61-L74)). Also, testing useragents using generated regex [is faster](https://gist.github.com/dangreen/55c41072d8891efd3a772a4739d6cd9d) than using the `matchesUA` method from browserslist-useragent. ## CLI ```bash pnpm browserslist-useragent-regexp [query] [...options] # or npx browserslist-useragent-regexp [query] [...options] # or yarn exec -- browserslist-useragent-regexp [query] [...options] ``` Also, short alias is available: ```bash pnpm bluare [query] [...options] ``` | Option | Description | Default | |--------|-------------|---------| | query | Manually provide a browserslist query. Specifying this overrides the browserslist configuration specified in your project. | | | ‑‑help, -h | Print this message. | | | ‑‑verbose, -v | Print additional info about regexes. | | | ‑‑ignorePatch | Ignore differences in patch browser numbers. | `true` | | ‑‑ignoreMinor | Ignore differences in minor browser versions. | `false` | | ‑‑allowHigherVersions | For all the browsers in the browserslist query, return a match if the useragent version is equal to or higher than the one specified in browserslist. | `false` | | ‑‑allowZeroSubversions | Ignore match of patch or patch and minor, if they are 0. | `false` | ## JS API basics Module exposes two main methods: ### [getUserAgentRegexes(options)](https://browserslist.github.io/browserslist-useragent-regexp/functions/getUserAgentRegexes.html) Compile browserslist query to [regexes for each browser](#regex-info-object). ### [getUserAgentRegex(options)](https://browserslist.github.io/browserslist-useragent-regexp/functions/getUserAgentRegex.html) Compile browserslist query to one regex. > [Description of all methods you can find in Documentation.](https://browserslist.github.io/browserslist-useragent-regexp/index.html) #### Options | Option | Type | Default | Description | |--------|------|---------|-------------| | browsers | `string \| string[]` | — | Manually provide a browserslist query (or an array of queries). Specifying this overrides the browserslist configuration specified in your project. | | ignorePatch | `boolean` | `true` | Ignore differences in patch browser numbers. | | ignoreMinor | `boolean` | `false` | Ignore differences in minor browser versions. | | allowHigherVersions | `boolean` | `false` | For all the browsers in the browserslist query, return a match if the useragent version is equal to or higher than the one specified in browserslist. | | allowZeroSubversions | `boolean` | `false` | Ignore match of patch or patch and minor, if they are 0. | Any of the [`browserslist` API options](https://github.com/browserslist/browserslist#js-api) may also be provided. #### Regex info object | Property | Type | Description | |----------|------|-------------| | family | `string` | Browser family. | | requestVersions | `[number, number, number][]` | Versions provided by browserslist. | | regex | `RegExp` | Regex to match useragent with family and versions. | | sourceRegex | `RegExp` | Original useragent regex, without versions. | | version | `[number, number, number] \| null` | Useragent version of regex. | | minVersion | `[number, number, number] \| null` | Useragent min version of regex. | | maxVersion | `[number, number, number] \| null` | Useragent max version of regex. | ## Other - [Supported browsers](https://github.com/browserslist/browserslist-useragent#supported-browsers) - [Notes](https://github.com/browserslist/browserslist-useragent#notes) - [When querying for modern browsers](https://github.com/browserslist/browserslist-useragent#when-querying-for-modern-browsers) --- _Source: https://npm.io/package/browserslist-useragent-regexp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._