Package Exports

browserslist-useragent

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (browserslist-useragent) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Browserslist Useragent

Find if a given user agent string satisfies a browserslist query.

It automatically reads the browserslist configuration specified in your project, but you can also specify the same using the options parameter.

Installation

npm install browserslist-useragent

Usage

const { matchesUA } = require('browserslist-useragent')
matchesUA(userAgentString, options)

// example
matchesUA('Mozilla/5.0 (Windows NT 10.0; rv:54.0) Gecko/20100101 Firefox/54.0', { browsers: ['Firefox > 53']})
// returns true

Option	Default Value	Description
browsers	—	Manually provide a browserslist query (or an array of queries). Specifying this overrides the browserslist configuration specified in your project.
ignorePatch	`true`	Ignore differences in patch browser numbers
ignoreMinor	`false`	Ignore differences in minor browser versions

Supported browsers

Chrome
Firefox
Safari
IE
Edge

PRs to add more browserslist supported browsers are welcome 👋

Notes

All browsers on iOS (Chrome, Firefox etc) use Safari's WebKit as the underlying engine, and hence will be resolved to Safari. Since browserslist is usually used for transpiling / autoprefixing for browsers, this behaviour is what's intended in most cases, but might surprise you otherwise.
Right now, Chrome for Android and Firefox for Android are resolved to their desktop equivalents. The caniuse database does not currently store historical data for these browsers separately (except the last version) See #156

When querying for modern browsers

It is a good idea to update this package often so that browser definitions are upto date.
It is also a good idea to add unreleased versions to your browserslist query, and set ignoreMinor and ignorePatch to true so that alpha / beta / canary versions of browsers are matched.
In case you're unable to keep this package up-to-date, you can set the _allowHigherVersions to true. For all the browsers specified in your browserslist query, this will return a match if the user agent version is equal to or higher than those specified in your browserslist query. Use this with care though, since it's a wildcard, and only lightly tested.