Composable user agent detection using Ramda, powered by ua-parser-js.
Because browsers have bugs bugz.
MDN offers some good advice about when and when not to use user agent detection.
Bugz isn't really another library, it's just a lightweight* functional wrapper around ua-parser-js.
* for those already using Ramda.
$ npm install ramda
$ npm install bugz
Ramda is defined as a peer dependency meaning it needs to be defined in your own package.json.
import { isOSName } from 'bugz';
const isWindows = isOSName('Windows');
if (isWindows(window.navigator.userAgent)) {
console.log('OS is Windows');
}import { isOSName, isBrowserName } from 'bugz';
import { allPass } from 'ramda';
const isWindows = isOSName('Windows');
const isFirefox = isBrowserName('Firefox');
const isWindowsFirefox = allPass([
isWindows,
isFirefox
]);
if (isWindowsFirefox(window.navigator.userAgent)) {
console.log('OS is Windows and Browser is Firefox');
}import { isOSName, isBrowserName, isBrowserVersionLt } from 'bugz';
import { allPass } from 'ramda';
const isWindows = isOSName('Windows');
const isFirefox = isBrowserName('Firefox');
const isBrowserVersionLt3_7 = isBrowserVersionLt('3.7');
const isWindowsFirefoxLt3_7 = allPass([
isWindows,
isFirefox,
isBrowserVersionLt3_7
]);
if (isWindowsFirefoxLt3_7(window.navigator.userAgent)) {
console.log('OS is Windows and Browser is Firefox < 3.7');
}Further examples can be found here.
All functions are curried by default.
about (ua: string) → void
Logs all information obtained from the user agent string to the console.
getBrowser (ua: string) → { name: string, version: string, majorVersion: number }
Returns the browser from the user agent string.
getBrowserName (ua: string) → string
Returns the browser name from the user agent string.
getBrowserVersion (ua: string) → string
Returns the browser version from the user agent string.
getEngine (ua: string) → { name: string, version: string }
Returns the engine from the user agent string.
getEngineName (ua: string) → string
Returns the engine name from the user agent string.
getEngineVersion (ua: string) → string
Returns the engine version from the user agent string.
getOS (ua: string) → { name: string, version: string }
Returns the OS from the user agent string.
getOSName (ua: string) → string
Returns the OS name from the user agent string.
getOSVersion (ua: string) → string
Returns the OS version from the user agent string.
isAndroid (ua: string) → boolean
Returns whether or not the operating system is Android.
isAndroidBrowser (ua: string) → boolean
Returns whether or not the browser is Android Browser.
isBrowserName (name: string) → (ua: string) → boolean
Returns whether or not the browser name is name.
isBrowserVersion (version: string) → (ua: string) → boolean
Returns whether or not the browser version is version.
isBrowserVersionGt (version: string) → (ua: string) → boolean
Returns whether or not the browser version is greater than version.
isBrowserVersionGte (version: string) → (ua: string) → boolean
Returns whether or not the browser version is greater than or equal to version.
isBrowserVersionLt (version: string) → (ua: string) → boolean
Returns whether or not the browser version is less than version.
isBrowserVersionLte (version: string) → (ua: string) → boolean
Returns whether or not the browser version is less than or equal to version.
isChrome (ua: string) → boolean
Returns whether or not the browser is Chrome.
isEdge (ua: string) → boolean
Returns whether or not the browser is Edge.
isEdgeHTML (ua: string) → boolean
Returns whether or not the engine is EdgeHTML.
isEngineName (name: string) → (ua: string) → boolean
Returns whether or not the engine name is name.
isEngineVersion (version: string) → (ua: string) → boolean
Returns whether or not the engine version is version.
isEngineVersionGt (version: string) → (ua: string) → boolean
Returns whether or not the engine version is greater than version.
isEngineVersionGte (version: string) → (ua: string) → boolean
Returns whether or not the engine version is greater than or equal to version.
isEngineVersionLt (version: string) → (ua: string) → boolean
Returns whether or not the engine version is less than version.
isEngineVersionLte (version: string) → (ua: string) → boolean
Returns whether or not the engine version is less than or equal to version.
isFirefox (ua: string) → boolean
Returns whether or not the browser is Firefox.
isGecko (ua: string) → boolean
Returns whether or not the engine is Gecko.
isIE (ua: string) → boolean
Returns whether or not the browser is Internet Explorer.
isIEMobile (ua: string) → boolean
Returns whether or not the browser is Internet Explorer Mobile.
isIOS (ua: string) → boolean
Returns whether or not the operating system is iOS.
isMacOS (ua: string) → boolean
Returns whether or not the operating system is Mac OS.
isMobileSafari (ua: string) → boolean
Returns whether or not the browser is Mobile Safari.
isOSName (name: string) → (ua: string) → boolean
Returns whether or not the OS name is name.
isOSVersion (version: string) → (ua: string) → boolean
Returns whether or not the OS version is version.
isOSVersionGt (version: string) → (ua: string) → boolean
Returns whether or not the OS version is greater than version.
isOSVersionGte (version: string) → (ua: string) → boolean
Returns whether or not the OS version is greater than or equal to version.
isOSVersionLt (version: string) → (ua: string) → boolean
Returns whether or not the OS version is less than version.
isOSVersionLte (version: string) → (ua: string) → boolean
Returns whether or not the OS version is less than or equal to version.
isOpera (ua: string) → boolean
Returns whether or not the browser is Opera.
isOperaMobile (ua: string) → boolean
Returns whether or not the browser is Opera Mobile.
isPresto (ua: string) → boolean
Returns whether or not the engine is Presto.
isSafari (ua: string) → boolean
Returns whether or not the browser is Safari (desktop).
isTrident (ua: string) → boolean
Returns whether or not the engine is Trident.
isWebKit (ua: string) → boolean
Returns whether or not the engine is WebKit.
isWindows (ua: string) → boolean
Returns whether or not the operating system is Windows.
isWindowsPhone (ua: string) → boolean
Returns whether or not the operating system is Windows Phone.
parse (ua: string) → { ua: string, browser: { name: string, version: string, majorVersion: string }, engine: { name: string, version: string }, os: { name: string, version: string }
Returns all information obtained from the user agent string.
import { isBrowserName } from 'bugz';Unfortuantely tree shaking isn't particularly effective on Bugz because most exports are pure curried functions which aren't currently susceptible to dead code elimination. Therefore, a modular CommonJS build is additionally offered.
const bugz = require('bugz');// Or modular for optimized builds
const isBrowserName = require('bugz/isBrowserName');
const isBrowserVersion = require('bugz/isBrowserVersion');<script src="bugz.umd.js"></script>
<script>
const isBrowserName = Bugz.isBrowserName;
</script>require(['bugz'], bugz => {});MIT
BrowserStack for providing a free subscription to support cross browser testing.