chore: move the token to secrets

Co-authored-by: Lucio Martinez <martinezlucio.com@gmail.com>

.babelrc

@@ -1,7 +1,8 @@
 {
   "presets": [["@babel/preset-env", {
     "useBuiltIns": "entry",
-    "modules": "umd",
+    "modules": "cjs",
+    "loose": true,
     "targets": {
       "ie": "8",
       "browsers": ">2%"

.coveralls.yml

@@ -1 +1 @@
-repo_token: Ba2bS7pOlSLZWuESBnff8qxDjIS8Mg1Z0
+

.eslintrc.yml

@@ -3,6 +3,12 @@ extends: airbnb-base
 rules:
   no-underscore-dangle: 0
   no-void: 0
+  import/extensions:
+    - 'error'
+    - 'ignorePackages'
+    - {js: 'always'}
+  import/prefer-default-export: 1
+
 plugins:
   - ava
   - import

.github/CONTRIBUTING.md

@@ -12,12 +12,23 @@ If it's a small hot-fix, an improvement to the docs, or added support for a new
 
 Following these simple rules will really help maintain the repo! Thanks ❤️
 
-## Adding Tests
+## Adding Browser Support and Tests
 
 See the list in `test/acceptance/useragentstrings.yml` with example user agents and their expected `bowser` object.
 
-Whenever you add support for new browsers or notice a bug / mismatch, please update the list and
-check if all tests are still passing.
+Whenever you add support for new browsers or notice a bug / mismatch, please update the list and check if all tests are still passing. Also, make sure to keep the list of browser aliases up-to-date in `src/constants.js`.
+
+For creating aliases, keep the following guidelines in mind:
+ - use only lowercase letters for names
+ - replace special characters such as space and dashes by underscore
+ - whenever possible drop the word `browser` from the original browser name
+ - always check for possible duplicates
+ - aliases are supposed to also be a shorter version of the original name
+
+Examples:
+`Opera Coast` --> `opera_coast`
+`UC Browser`  --> `uc`
+`SeaMonkey`   --> `seamonkey`
 
 ## Testing
 

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: lancedikson
+open_collective: lancedikson

.github/release-drafter.yml

@@ -0,0 +1,19 @@
+name-template: 'v$RESOLVED_VERSION 🌈'
+tag-template: 'v$RESOLVED_VERSION'
+version-resolver:
+  major:
+    labels:
+      - major
+  minor:
+    labels:
+      - minor
+  patch:
+    labels:
+      - patch
+  default: patch
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\<*_&'
+template: |
+  ## Changes
+
+  $CHANGES

.github/workflows/draft-or-update-next-release.yml

@@ -0,0 +1,20 @@
+name: 📝 Draft or update next release
+concurrency: draft_or_update_next_release
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  prepare-deployment:
+    name: 📝 Draft or update next release
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v1
+
+      - uses: release-drafter/release-drafter@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/merge-to-master.yml

@@ -0,0 +1,38 @@
+name: 'Merge to master'
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [12.16.3]
+
+    steps:
+      - name: Get branch name (merge)
+        if: github.event_name != 'pull_request'
+        shell: bash
+        run: echo "BRANCH_NAME=$(echo ${GITHUB_REF#refs/heads/} | tr / -)" >> $GITHUB_ENV
+
+      - name: Get branch name (pull request)
+        if: github.event_name == 'pull_request'
+        shell: bash
+        run: echo "BRANCH_NAME=$(echo ${GITHUB_HEAD_REF} | tr / -)" >> $GITHUB_ENV
+
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm i -g nyc
+      - run: npm ci
+      - run: npm run build
+      - run: nyc npm test && nyc report --reporter=text-lcov | ./node_modules/coveralls/bin/coveralls.js
+        env:
+          COVERALLS_SERVICE_NAME: GithubActions
+          COVERALLS_REPO_TOKEN: ${{ secrets.COVERALLS_REPO_TOKEN }}
+          COVERALLS_GIT_BRANCH: ${{ env.BRANCH_NAME }}

.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Release
+
+on:
+  # This job runs when a new release is published
+  release:
+    types: [published]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+        with:
+          node-version: 16
+          registry-url: https://registry.npmjs.org
+      - uses: actions/cache@v2
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package.json') }}
+      # Store the name of the release
+      # See https://stackoverflow.com/questions/58177786/get-the-current-pushed-tag-in-github-actions
+      - run: echo "RELEASE_VERSION=${GITHUB_REF#refs/*/}" >> $GITHUB_ENV
+      - run: npm ci
+      - run: npm version $RELEASE_VERSION --no-git-tag-version
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.BOWSER_NPM_PUBLISH_TOKEN }}

.github/workflows/pull-request.yml

@@ -0,0 +1,44 @@
+name: 'Pull Request'
+on:
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: [12.16.3]
+    name: Node ${{ matrix.node }}
+    steps:
+      - name: 'Checkout latest code'
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+      - name: Set up node
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node }}
+      - name: Install dependencies
+        run: npm ci
+      - name: Build
+        run: npm run build
+      - name: Run tests
+        run: npm run test
+
+  lint:
+    name: 'ESLint'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout latest code
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+      - name: Set up node
+        uses: actions/setup-node@v3
+        with:
+          node-version: '16'
+      - name: Install dependencies
+        run: npm ci
+      - name: Run ESLint
+        run: npm run lint:check

.gitignore

@@ -3,5 +3,5 @@ node_modules/
 .nyc_output
 coverage
 dist
-bundled.js
-es5.js
+bundled.js*
+es5.js*

.npmignore

@@ -3,3 +3,8 @@ test
 coverage
 **/.*
 node_modules
+.github
+docs
+*.gz
+jsdoc.json
+webpack.config.js

.travis.yml

@@ -1,8 +0,0 @@
-language: node_js
-after_success: npm run coverage
-node_js:
-  - "8.4.0"
-script:
-- npm run lint
-- npm run build
-- npm test

CHANGELOG.md

@@ -1,5 +1,88 @@
 # Bowser Changelog
 
+### 2.11.0 (Sep 12, 2020)
+- [ADD] Added support for aliases in `Parser#is` method (#437)
+- [ADD] Added more typings (#438, #427)
+- [ADD] Added support for MIUI Browser (#436)
+
+### 2.10.0 (Jul 9, 2020)
+- [FIX] Fix for Firefox detection on iOS 13 [#415]
+- [FIX] Fixes for typings.d.ts [#409]
+- [FIX] Updated development dependencies
+
+### 2.9.0 (Jan 28, 2020)
+- [ADD] Export more methods and constants via .d.ts [#388], [#390]
+
+### 2.8.1 (Dec 26, 2019)
+- [FIX] Reverted [#382] as it broke build
+
+### 2.8.0 (Dec 26, 2019)
+- [ADD] Add polyfills for Array.find & Object.assign [#383]
+- [ADD] Export constants with types.d.ts [#382]
+- [FIX] Add support for WeChat on Windows [#381]
+- [FIX] Fix detection of Firefox on iPad [#379]
+- [FIX] Add detection of Electron [#375]
+- [FIX] Updated dev-dependencies
+
+### 2.7.0 (Oct 2, 2019)
+- [FIX] Add support for QQ Browser [#362]
+- [FIX] Add support for GSA [#364]
+- [FIX] Updated dependencies
+
+### 2.6.0 (Sep 6, 2019)
+- [ADD] Define "module" export in package.json [#354]
+- [FIX] Fix Tablet PC detection [#334]
+
+### 2.5.4 (Sep 2, 2019)
+- [FIX] Exclude docs from the npm package [#349]
+
+### 2.5.3 (Aug 4, 2019)
+- [FIX] Add MacOS names support [#338]
+- [FIX] Point typings.d.ts from package.json [#341]
+- [FIX] Upgrade dependencies
+
+### 2.5.2 (July 17, 2019)
+- [FIX] Fixes the bug undefined method because of failed build (#335)
+
+### 2.5.1 (July 17, 2019)
+- [FIX] Fixes the bug with a custom Error class (#335)
+- [FIX] Fixes the settings for Babel to reduce the bundle size (#259)
+
+### 2.5.0 (July 16, 2019)
+- [ADD] Add constant output so that users can quickly get all types (#325)
+- [FIX] Add support for Roku OS (#332)
+- [FIX] Update devDependencies
+- [FIX] Fix docs, README and added funding information
+
+### 2.4.0 (May 3, 2019)
+- [FIX] Update regexp for generic browsers (#310)
+- [FIX] Fix issues with module.exports (#318)
+- [FIX] Update devDependencies (#316, #321, #322)
+- [FIX] Fix docs (#320)
+
+### 2.3.0 (April 14, 2019)
+- [ADD] Add support for Blink-based MS Edge (#311)
+- [ADD] Add more types for TS (#289)
+- [FIX] Update dev-dependencies
+- [FIX] Update docs
+
+### 2.2.1 (April 12, 2019)
+- [ADD] Add an alias for Samsung Internet
+- [FIX] Fix browser name detection for browsers without an alias (#313)
+
+### 2.2.0 (April 7, 2019)
+- [ADD] Add short aliases for browser names (#295)
+- [FIX] Fix Yandex Browser version detection (#308)
+
+### 2.1.2 (March 6, 2019)
+- [FIX] Fix buggy `getFirstMatch` reference
+
+### 2.1.1 (March 6, 2019)
+- [ADD] Add detection of PlayStation 4 (#291)
+- [ADD] Deploy docs on GH Pages (#293)
+- [FIX] Fix files extensions for importing (#294)
+- [FIX] Fix docs (#295)
+
 ### 2.1.0 (January 24, 2019)
 - [ADD] Add new `Parser.getEngineName()` method (#288)
 - [ADD] Add detection of ChromeOS (#287)

README.md

@@ -1,25 +1,27 @@
 ## Bowser
-A browser detector. Because sometimes, there is no other way, and not even good modern browsers always provide good feature detection mechanisms.
+A small, fast and rich-API browser/platform/engine detector for both browser and node.
+- **Small.** Use plain ES5-version which is ~4.8kB gzipped.
+- **Optimized.** Use only those parsers you need — it doesn't do useless work.
+- **Multi-platform.** It's browser- and node-ready, so you can use it in any environment.
 
-[![Build Status](https://travis-ci.org/lancedikson/bowser.svg?branch=master)](https://travis-ci.org/lancedikson/bowser/) [![Greenkeeper badge](https://badges.greenkeeper.io/lancedikson/bowser.svg)](https://greenkeeper.io/)[![Coverage Status](https://coveralls.io/repos/github/lancedikson/bowser/badge.svg?branch=master)](https://coveralls.io/github/lancedikson/bowser?branch=master)
+Don't hesitate to support the project on Github or [OpenCollective](https://opencollective.com/bowser) if you like it ❤️ Also, contributors are always welcome!
+
+[![Financial Contributors on Open Collective](https://opencollective.com/bowser/all/badge.svg?label=financial+contributors)](https://opencollective.com/bowser) [![Build Status](https://travis-ci.org/lancedikson/bowser.svg?branch=master)](https://travis-ci.org/lancedikson/bowser/)  [![Greenkeeper badge](https://badges.greenkeeper.io/lancedikson/bowser.svg)](https://greenkeeper.io/)  [![Coverage Status](https://coveralls.io/repos/github/lancedikson/bowser/badge.svg?branch=master)](https://coveralls.io/github/lancedikson/bowser?branch=master) ![Downloads](https://img.shields.io/npm/dm/bowser)
 
 # Contents
 - [Overview](#overview)
 - [Use cases](#use-cases)
-- [Advanced usage](#advanced-usage)
-- [How can I help?](#contributing)
 
 # Overview
 
-The library is made to help to detect what browser your user has and gives you a convenient API to filter the users somehow depending on their browsers.
+The library is made to help to detect what browser your user has and gives you a convenient API to filter the users somehow depending on their browsers. Check it out on this page: https://bowser-js.github.io/bowser-online/.
 
-**Changes of version 2.0**
+### ⚠️ Version 2.0 breaking changes ⚠️
 
-The version 2.0 has drastically changed API. All available methods can be found in the `docs` folder from now on and on a webpage soon.
+Version 2.0 has drastically changed the API. All available methods are on the [docs page](https://bowser-js.github.io/bowser/docs/).
 
 _For legacy code, check out the [1.x](https://github.com/lancedikson/bowser/tree/v1.x) branch and install it through `npm install bowser@1.9.4`._
 
-
 # Use cases
 
 First of all, require the library. This is a UMD Module, so it will work for AMD, TypeScript, ES6, and CommonJS module systems.
@@ -54,20 +56,20 @@ console.log(`The current browser name is "${browser.getBrowserName()}"`);
 or
 
 ```javascript
-const impression = new Impression();
-
 const browser = Bowser.getParser(window.navigator.userAgent);
-const browserInfo = browser.getBrowser();
-impression.brName = browserInfo.name;
-impression.brVer = browserInfo.version;
+console.log(browser.getBrowser());
+
+// outputs
+{
+  name: "Internet Explorer"
+  version: "11.0"
+}
 ```
 
 or
 
 ```javascript
-const browser = Bowser.getParser(window.navigator.userAgent);
-impression.userTechData = browser.parse();
-console.log(impression.userTechData);
+console.log(Bowser.parse(window.navigator.userAgent));
 
 // outputs
 {
@@ -116,13 +118,13 @@ const isValidBrowser = browser.satisfies({
   // or in general
   chrome: "~20.1.1432",
   firefox: ">31",
-  opera: ">=22"
+  opera: ">=22",
 
   // also supports equality operator
   chrome: "=20.1.1432", // will match particular build only
 
   // and loose-equality operator
-  chrome: "~20"         // will match any 20.* sub-version
+  chrome: "~20",        // will match any 20.* sub-version
   chrome: "~20.1"       // will match any 20.1.* sub-version (20.1.19 as well as 20.1.12.42-alpha.1)
 });
 ```
@@ -132,8 +134,44 @@ Thus, you can define OS or platform specific rules and they will have more prior
 
 More of API and possibilities you will find in the `docs` folder.
 
-### Similar Projects
+### Browser names for `.satisfies()`
+
+By default you are supposed to use the full browser name for `.satisfies`.
+But, there's a short way to define a browser using short aliases. The full
+list of aliases can be found in [the file](src/constants.js).
+
+## Similar Projects
 * [Kong](https://github.com/BigBadBleuCheese/Kong) - A C# port of Bowser.
 
-### License
+## Contributors
+
+### Code Contributors
+
+This project exists thanks to all the people who contribute. [[Contribute](.github/CONTRIBUTING.md)].
+<a href="https://github.com/lancedikson/bowser/graphs/contributors"><img src="https://opencollective.com/bowser/contributors.svg?width=890&button=false" /></a>
+
+### Financial Contributors
+
+Become a financial contributor and help us sustain our community. [[Contribute](https://opencollective.com/bowser/contribute)]
+
+#### Individuals
+
+<a href="https://opencollective.com/bowser"><img src="https://opencollective.com/bowser/individuals.svg?width=890"></a>
+
+#### Organizations
+
+Support this project with your organization. Your logo will show up here with a link to your website. [[Contribute](https://opencollective.com/bowser/contribute)]
+
+<a href="https://opencollective.com/bowser/organization/0/website"><img src="https://opencollective.com/bowser/organization/0/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/1/website"><img src="https://opencollective.com/bowser/organization/1/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/2/website"><img src="https://opencollective.com/bowser/organization/2/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/3/website"><img src="https://opencollective.com/bowser/organization/3/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/4/website"><img src="https://opencollective.com/bowser/organization/4/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/5/website"><img src="https://opencollective.com/bowser/organization/5/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/6/website"><img src="https://opencollective.com/bowser/organization/6/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/7/website"><img src="https://opencollective.com/bowser/organization/7/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/8/website"><img src="https://opencollective.com/bowser/organization/8/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/9/website"><img src="https://opencollective.com/bowser/organization/9/avatar.svg"></a>
+
+## License
 Licensed as MIT. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.

docs/Bowser.html

@@ -13,6 +13,7 @@
     <![endif]-->
     <link type="text/css" rel="stylesheet" href="styles/prettify.css">
     <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 </head>
 <body>
@@ -24,9 +25,9 @@
 
 <label for="nav-trigger" class="overlay"></label>
 
-<nav>
+<nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3><a href="global.html">Global</a></h3>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#assign">assign</a></li><li><a href="global.html#find">find</a></li><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getMacOSVersionName">getMacOSVersionName</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
 </nav>
 
 <div id="main">
@@ -47,108 +48,20 @@
         Bowser
         </h2>
         
-            <div class="class-description"><p>Bowser class.
-Keep it simple as much as it can be.
-It's supposed to work with collections of <a href="Parser.html">Parser</a> instances
-rather then solve one-instance problems.
-All the one-instance stuff is located in Parser class.</p></div>
+            <div class="class-description"><p>Bowser is a static object, that provides an API to the Parsers</p></div>
         
     
 </header>
 
 <article>
     
-        <div class="container-overview">
-        
-            
-
-    
-    <h2>Constructor</h2>
-    
-
-    <h4 class="name" id="Bowser"><span class="type-signature"></span>new Bowser<span class="signature">()</span><span class="type-signature"></span></h4>
-
-    
-
-
-
-
-<dl class="details">
-
-    
-    <dt class="tag-source">Source:</dt>
-    <dd class="tag-source"><ul class="dummy"><li>
-        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line16">line 16</a>
-    </li></ul></dd>
-    
 
     
 
     
 
     
-
     
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-
-    
-</dl>
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-        
-        </div>
-    
-
-    
-
-    
-
     
 
      
@@ -177,7 +90,7 @@ All the one-instance stuff is located in Parser class.</p></div>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line29">line 29</a>
+        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line40">line 40</a>
     </li></ul></dd>
     
 
@@ -217,7 +130,7 @@ All the one-instance stuff is located in Parser class.</p></div>
 
 
 <div class="description">
-    <p>Creates a module:parser:Parser instance</p>
+    <p>Creates a <a href="Parser.html">Parser</a> instance</p>
 </div>
 
 
@@ -332,7 +245,8 @@ const result = parser.getResult();</code></pre>
                 </td>
             
 
-            <td class="description last"><p>same as skipParsing for <a href="Parser.html">Parser</a></p></td>
+            <td class="description last"><p>Will make the Parser postpone parsing until you ask it
+explicitly. Same as <code>skipParsing</code> for <a href="Parser.html">Parser</a>.</p></td>
         </tr>
 
     
@@ -350,6 +264,8 @@ const result = parser.getResult();</code></pre>
 
 
 
+
+
 <h5>Throws:</h5>
 
         
@@ -401,6 +317,7 @@ const result = parser.getResult();</code></pre>
     
 
 
+
         
             
 
@@ -418,7 +335,7 @@ const result = parser.getResult();</code></pre>
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line45">line 45</a>
+        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line56">line 56</a>
     </li></ul></dd>
     
 
@@ -532,6 +449,8 @@ const result = parser.getResult();</code></pre>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -552,6 +471,7 @@ const result = parser.getResult();</code></pre>
     
 
 
+
         
     
 
@@ -572,12 +492,14 @@ const result = parser.getResult();</code></pre>
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sat Jan 19 2019 15:43:45 GMT+0200 (EET) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Sat Sep 12 2020 11:21:13 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
 <script src="scripts/linenumber.js"></script>
 
 
+
 </body>
 </html>

docs/BowserUAIsNotAStringError.html

@@ -0,0 +1,234 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    
+    <meta charset="utf-8">
+    <title>BowserUAIsNotAStringError - Documentation</title>
+    
+    
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body>
+
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+
+<label for="nav-trigger" class="overlay"></label>
+
+<nav >
+    
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="BowserUAIsNotAStringError.html">BowserUAIsNotAStringError</a></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
+</nav>
+
+<div id="main">
+    
+    <h1 class="page-title">BowserUAIsNotAStringError</h1>
+    
+
+    
+
+
+
+
+<section>
+
+<header>
+    
+        <h2>
+        BowserUAIsNotAStringError
+        </h2>
+        
+    
+</header>
+
+<article>
+    
+        <div class="container-overview">
+        
+            
+
+    
+
+    <h4 class="name" id="BowserUAIsNotAStringError"><span class="type-signature"></span>new BowserUAIsNotAStringError<span class="signature">()</span><span class="type-signature"></span></h4>
+
+    
+
+
+
+
+<dl class="details">
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line20">line 20</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+    <h5 class="subsection-title">Properties:</h5>
+
+    
+
+<table class="props">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>name</code></td>
+            
+
+            <td class="type">
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last"></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+        
+        </div>
+    
+
+    
+
+    
+
+    
+    
+    
+
+     
+
+    
+
+    
+
+    
+
+    
+
+    
+</article>
+
+</section>
+
+
+
+
+    
+    
+</div>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Tue Jul 16 2019 22:20:27 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+</footer>
+
+<script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
+<script src="scripts/linenumber.js"></script>
+
+
+
+</body>
+</html>

docs/Parser.html

@@ -13,6 +13,7 @@
     <![endif]-->
     <link type="text/css" rel="stylesheet" href="styles/prettify.css">
     <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 </head>
 <body>
@@ -24,9 +25,9 @@
 
 <label for="nav-trigger" class="overlay"></label>
 
-<nav>
+<nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3><a href="global.html">Global</a></h3>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#assign">assign</a></li><li><a href="global.html#find">find</a></li><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getMacOSVersionName">getMacOSVersionName</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
 </nav>
 
 <div id="main">
@@ -74,7 +75,7 @@
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line10">line 10</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line23">line 23</a>
     </li></ul></dd>
     
 
@@ -247,6 +248,9 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
+
         
         </div>
     
@@ -256,6 +260,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
     
+    
+    
 
      
 
@@ -345,6 +351,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -368,6 +376,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -447,6 +456,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -474,6 +485,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -553,6 +565,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -580,6 +594,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -659,6 +674,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -682,6 +699,116 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
+        
+            
+
+    
+
+    <h4 class="name" id="getEngineName"><span class="type-signature"></span>getEngineName<span class="signature">()</span><span class="type-signature"> &rarr; {String}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line281">line 281</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+<div class="description">
+    <p>Get engines's name</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    <p>Engines's name or an empty string</p>
+</div>
+
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">String</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
         
             
 
@@ -773,6 +900,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -793,6 +922,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -936,6 +1066,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -960,6 +1092,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -1039,6 +1172,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -1066,6 +1201,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -1145,6 +1281,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -1168,6 +1306,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -1319,6 +1458,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -1339,6 +1480,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -1356,7 +1498,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line317">line 317</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line331">line 331</a>
     </li></ul></dd>
     
 
@@ -1418,6 +1560,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -1441,6 +1585,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
@@ -1520,6 +1665,8 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
 
 
 
+
+
 
 
 
@@ -1547,12 +1694,13 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
 
 
+
         
             
 
     
 
-    <h4 class="name" id="is"><span class="type-signature"></span>is<span class="signature">(anything)</span><span class="type-signature"> &rarr; {Boolean}</span></h4>
+    <h4 class="name" id="is"><span class="type-signature"></span>is<span class="signature">(anything, includingAlias<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {Boolean}</span></h4>
 
     
 
@@ -1564,7 +1712,7 @@ like <a href="Parser.html#parseBrowser">Parser#parseBrowser</a> or <a href="Pars
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line446">line 446</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line481">line 481</a>
     </li></ul></dd>
     
 
@@ -1631,8 +1779,12 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
         <th>Type</th>
 
         
+        <th>Attributes</th>
+        
 
         
+        <th>Default</th>
+        
 
         <th class="last">Description</th>
     </tr>
@@ -1656,13 +1808,59 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
             </td>
 
             
+                <td class="attributes">
+                
 
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
             
 
             <td class="description last"></td>
         </tr>
 
     
+
+        <tr>
+            
+                <td class="name"><code>includingAlias</code></td>
+            
+
+            <td class="type">
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>false</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>The flag showing whether alias will be included into comparison</p></td>
+        </tr>
+
+    
     </tbody>
 </table>
 
@@ -1679,6 +1877,8 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -1699,12 +1899,13 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
 
 
+
         
             
 
     
 
-    <h4 class="name" id="parse"><span class="type-signature"></span>parse<span class="signature">()</span><span class="type-signature"></span></h4>
+    <h4 class="name" id="isBrowser"><span class="type-signature"></span>isBrowser<span class="signature">(browserName, includingAlias<span class="signature-attributes">opt</span>)</span><span class="type-signature"> &rarr; {boolean}</span></h4>
 
     
 
@@ -1716,7 +1917,206 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line304">line 304</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line415">line 415</a>
+    </li></ul></dd>
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+<div class="description">
+    <p>Check if the browser name equals the passed string</p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+        <th>Attributes</th>
+        
+
+        
+        <th>Default</th>
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>browserName</code></td>
+            
+
+            <td class="type">
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                </td>
+            
+
+            <td class="description last"><p>The string to compare with the browser name</p></td>
+        </tr>
+
+    
+
+        <tr>
+            
+                <td class="name"><code>includingAlias</code></td>
+            
+
+            <td class="type">
+            
+            </td>
+
+            
+                <td class="attributes">
+                
+                    &lt;optional><br>
+                
+
+                
+
+                
+                </td>
+            
+
+            
+                <td class="default">
+                
+                    <code>false</code>
+                
+                </td>
+            
+
+            <td class="description last"><p>The flag showing whether alias will be included into comparison</p></td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type">boolean</span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+        
+            
+
+    
+
+    <h4 class="name" id="parse"><span class="type-signature"></span>parse<span class="signature">()</span><span class="type-signature"> &rarr; {<a href="Parser.html">Parser</a>}</span></h4>
+
+    
+
+
+
+
+<dl class="details">
+
+    
+    <dt class="tag-source">Source:</dt>
+    <dd class="tag-source"><ul class="dummy"><li>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line318">line 318</a>
     </li></ul></dd>
     
 
@@ -1780,6 +2180,27 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
 
 
+
+
+
+<h5>Returns:</h5>
+
+        
+
+
+<dl class="param-type">
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type"><a href="Parser.html">Parser</a></span>
+
+
+    </dd>
+</dl>
+
+    
 
 
 
@@ -1862,6 +2283,8 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
 
 
+
+
 
 
 
@@ -1885,6 +2308,7 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
 
 
+
         
             
 
@@ -1902,7 +2326,7 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line279">line 279</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line292">line 292</a>
     </li></ul></dd>
     
 
@@ -1964,6 +2388,8 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
 
 
+
+
 
 
 
@@ -1987,6 +2413,7 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
 
 
+
         
             
 
@@ -2066,6 +2493,8 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
 
 
+
+
 
 
 
@@ -2092,6 +2521,7 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
 
 
+
         
             
 
@@ -2171,6 +2601,8 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
 
 
+
+
 
 
 
@@ -2194,6 +2626,7 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
 
 
+
         
             
 
@@ -2211,7 +2644,7 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line339">line 339</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line353">line 353</a>
     </li></ul></dd>
     
 
@@ -2264,12 +2697,12 @@ the OS called &quot;anything&quot; or the platform called &quot;anything&quot;</
 
     <h5>Example</h5>
     
-    <pre class="prettyprint"><code>const browser = new Bowser(UA);
-if (browser.check({chrome: '>118.01.1322' }))
+    <pre class="prettyprint"><code>const browser = Bowser.getParser(window.navigator.userAgent);
+if (browser.satisfies({chrome: '>118.01.1322' }))
 // or with os
-if (browser.check({windows: { chrome: '>118.01.1322' } }))
+if (browser.satisfies({windows: { chrome: '>118.01.1322' } }))
 // or with platforms
-if (browser.check({desktop: { chrome: '>118.01.1322' } }))</code></pre>
+if (browser.satisfies({desktop: { chrome: '>118.01.1322' } }))</code></pre>
 
 
 
@@ -2337,6 +2770,8 @@ and should have browsers specs on the bottom-laying layer</p></td>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -2365,6 +2800,7 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
     
 
 
+
         
             
 
@@ -2382,7 +2818,7 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
     
     <dt class="tag-source">Source:</dt>
     <dd class="tag-source"><ul class="dummy"><li>
-        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line455">line 455</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line491">line 491</a>
     </li></ul></dd>
     
 
@@ -2496,6 +2932,8 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -2516,6 +2954,7 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
     
 
 
+
         
             
 
@@ -2647,6 +3086,8 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -2667,6 +3108,7 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
     
 
 
+
         
     
 
@@ -2687,12 +3129,14 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sat Jan 19 2019 15:43:45 GMT+0200 (EET) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Sat Sep 12 2020 11:21:13 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
 <script src="scripts/linenumber.js"></script>
 
 
+
 </body>
 </html>

docs/bowser.js.html

@@ -13,6 +13,7 @@
     <![endif]-->
     <link type="text/css" rel="stylesheet" href="styles/prettify.css">
     <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 </head>
 <body>
@@ -24,9 +25,9 @@
 
 <label for="nav-trigger" class="overlay"></label>
 
-<nav>
+<nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3><a href="global.html">Global</a></h3>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#assign">assign</a></li><li><a href="global.html#find">find</a></li><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getMacOSVersionName">getMacOSVersionName</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
 </nav>
 
 <div id="main">
@@ -45,9 +46,15 @@
  * Bowser - a browser detector
  * https://github.com/lancedikson/bowser
  * MIT License | (c) Dustin Diaz 2012-2015
- * MIT License | (c) Denis Demchenko 2015-2017
+ * MIT License | (c) Denis Demchenko 2015-2019
  */
-import Parser from './parser';
+import Parser from './parser.js';
+import {
+  BROWSER_MAP,
+  ENGINE_MAP,
+  OS_MAP,
+  PLATFORMS_MAP,
+} from './constants.js';
 
 /**
  * Bowser class.
@@ -55,13 +62,18 @@ import Parser from './parser';
  * It's supposed to work with collections of {@link Parser} instances
  * rather then solve one-instance problems.
  * All the one-instance stuff is located in Parser class.
+ *
+ * @class
+ * @classdesc Bowser is a static object, that provides an API to the Parsers
+ * @hideconstructor
  */
 class Bowser {
   /**
-   * Creates a {@link module:parser:Parser} instance
+   * Creates a {@link Parser} instance
    *
    * @param {String} UA UserAgent string
-   * @param {Boolean} [skipParsing=false] same as skipParsing for {@link Parser}
+   * @param {Boolean} [skipParsing=false] Will make the Parser postpone parsing until you ask it
+   * explicitly. Same as `skipParsing` for {@link Parser}.
    * @returns {Parser}
    * @throws {Error} when UA is not a String
    *
@@ -88,6 +100,22 @@ class Bowser {
   static parse(UA) {
     return (new Parser(UA)).getResult();
   }
+
+  static get BROWSER_MAP() {
+    return BROWSER_MAP;
+  }
+
+  static get ENGINE_MAP() {
+    return ENGINE_MAP;
+  }
+
+  static get OS_MAP() {
+    return OS_MAP;
+  }
+
+  static get PLATFORMS_MAP() {
+    return PLATFORMS_MAP;
+  }
 }
 
 export default Bowser;
@@ -105,12 +133,14 @@ export default Bowser;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sat Jan 19 2019 15:43:45 GMT+0200 (EET) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Sat Sep 12 2020 11:21:13 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
 <script src="scripts/linenumber.js"></script>
 
 
+
 </body>
 </html>

docs/index.html

@@ -13,6 +13,7 @@
     <![endif]-->
     <link type="text/css" rel="stylesheet" href="styles/prettify.css">
     <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 </head>
 <body>
@@ -24,9 +25,9 @@
 
 <label for="nav-trigger" class="overlay"></label>
 
-<nav>
+<nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3><a href="global.html">Global</a></h3>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#assign">assign</a></li><li><a href="global.html#find">find</a></li><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getMacOSVersionName">getMacOSVersionName</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
 </nav>
 
 <div id="main">
@@ -39,6 +40,11 @@
     
 
 
+    <section class="package">
+        <h3> </h3>		
+    </section>
+
+
 
 
 
@@ -49,41 +55,61 @@
     
 
 
+
     <section class="readme">
-        <article><h2>Bowser</h2><p>A browser detector. Because sometimes, there is no other way, and not even good modern browsers always provide good feature detection mechanisms.</p>
-<p><a href="https://travis-ci.org/lancedikson/bowser/"><img src="https://travis-ci.org/lancedikson/bowser.svg?branch=master" alt="Build Status"></a> <a href="https://greenkeeper.io/"><img src="https://badges.greenkeeper.io/lancedikson/bowser.svg" alt="Greenkeeper badge"></a></p>
-<h1>Contents</h1><ul>
+        <article><h2>Bowser</h2>
+<p>A small, fast and rich-API browser/platform/engine detector for both browser and node.</p>
+<ul>
+<li><strong>Small.</strong> Use plain ES5-version which is ~4.8kB gzipped.</li>
+<li><strong>Optimized.</strong> Use only those parsers you need — it doesn't do useless work.</li>
+<li><strong>Multi-platform.</strong> It's browser- and node-ready, so you can use it in any environment.</li>
+</ul>
+<p>Don't hesitate to support the project on Github or <a href="https://opencollective.com/bowser">OpenCollective</a> if you like it ❤️ Also, contributors are always welcome!</p>
+<p><a href="https://opencollective.com/bowser"><img src="https://opencollective.com/bowser/all/badge.svg?label=financial+contributors" alt="Financial Contributors on Open Collective"></a> <a href="https://travis-ci.org/lancedikson/bowser/"><img src="https://travis-ci.org/lancedikson/bowser.svg?branch=master" alt="Build Status"></a>  <a href="https://greenkeeper.io/"><img src="https://badges.greenkeeper.io/lancedikson/bowser.svg" alt="Greenkeeper badge"></a>  <a href="https://coveralls.io/github/lancedikson/bowser?branch=master"><img src="https://coveralls.io/repos/github/lancedikson/bowser/badge.svg?branch=master" alt="Coverage Status"></a> <img src="https://img.shields.io/npm/dm/bowser" alt="Downloads"></p>
+<h1>Contents</h1>
+<ul>
 <li><a href="#overview">Overview</a></li>
 <li><a href="#use-cases">Use cases</a></li>
 <li><a href="#advanced-usage">Advanced usage</a></li>
 <li><a href="#contributing">How can I help?</a></li>
 </ul>
-<h1>Overview</h1><p>The library is made to help to detect what browser your user has and gives you a convenient API to filter the users somehow depending on their browsers.</p>
-<p><em>Please, note that this is an alpha version. Check out the <a href="https://github.com/lancedikson/bowser/tree/v1.x">1.x</a> branch for a stable version.</em></p>
-<p><strong>Changes of version 2.0</strong>
-The upcoming 2.0 version has drastically changed API. All available methods can be found in the <code>docs</code> folder from now on and on a webpage soon.</p>
-<h1>Use cases</h1><p>First of all, require the library. This is a UMD Module, so it will work for AMD, Typescript and CommonJS module systems.</p>
+<h1>Overview</h1>
+<p>The library is made to help to detect what browser your user has and gives you a convenient API to filter the users somehow depending on their browsers. Check it out on this page: https://bowser-js.github.io/bowser-online/.</p>
+<h3>⚠️ Version 2.0 breaking changes ⚠️</h3>
+<p>Version 2.0 has drastically changed the API. All available methods are on the <a href="https://lancedikson.github.io/bowser/docs">docs page</a>.</p>
+<p><em>For legacy code, check out the <a href="https://github.com/lancedikson/bowser/tree/v1.x">1.x</a> branch and install it through <code>npm install bowser@1.9.4</code>.</em></p>
+<h1>Use cases</h1>
+<p>First of all, require the library. This is a UMD Module, so it will work for AMD, TypeScript, ES6, and CommonJS module systems.</p>
 <pre class="prettyprint source lang-javascript"><code>const Bowser = require(&quot;bowser&quot;); // CommonJS
 
-import * as Bowser from &quot;bowser&quot; // Typescript</code></pre><p>By default, the exported version is the <em>ES5 transpiled version</em>, which <strong>do not</strong> include any polyfills.</p>
+import * as Bowser from &quot;bowser&quot;; // TypeScript
+
+import Bowser from &quot;bowser&quot;; // ES6 (and TypeScript with --esModuleInterop enabled)
+</code></pre>
+<p>By default, the exported version is the <em>ES5 transpiled version</em>, which <strong>do not</strong> include any polyfills.</p>
 <p>In case you don't use your own <code>babel-polyfill</code> you may need to have pre-built bundle with all needed polyfills.
 So, for you it's suitable to require bowser like this: <code>require('bowser/bundled')</code>.
 As the result, you get a ES5 version of bowser with <code>babel-polyfill</code> bundled together.</p>
 <p>You may need to use the source files, so they will be available in the package as well.</p>
-<h2>Browser props detection</h2><p>Often we need to pick users' browser properties such as the name, the version, the rendering engine and so on. Here is an example how to do it with Bowser:</p>
-<pre class="prettyprint source lang-javascript"><code>const browser = bowser.getParser(window.navigator.userAgent);
+<h2>Browser props detection</h2>
+<p>Often we need to pick users' browser properties such as the name, the version, the rendering engine and so on. Here is an example how to do it with Bowser:</p>
+<pre class="prettyprint source lang-javascript"><code>const browser = Bowser.getParser(window.navigator.userAgent);
 
 console.log(`The current browser name is &quot;${browser.getBrowserName()}&quot;`);
-// The current browser name is &quot;Internet Explorer&quot;</code></pre><p>or</p>
-<pre class="prettyprint source lang-javascript"><code>const impression = new Impression();
+// The current browser name is &quot;Internet Explorer&quot;
+</code></pre>
+<p>or</p>
+<pre class="prettyprint source lang-javascript"><code>const browser = Bowser.getParser(window.navigator.userAgent);
+console.log(browser.getBrowser());
 
-const browser = bowser.getParser(window.navigator.userAgent);
-const browserInfo = browser.getBrowser();
-impression.brName = browserInfo.name;
-impression.brVer = browserInfo.version;</code></pre><p>or</p>
-<pre class="prettyprint source lang-javascript"><code>const browser = bowser.getParser(window.navigator.userAgent);
-impression.userTechData = browser.parse();
-console.log(impression.userTechData);
+// outputs
+{
+  name: &quot;Internet Explorer&quot;
+  version: &quot;11.0&quot;
+}
+</code></pre>
+<p>or</p>
+<pre class="prettyprint source lang-javascript"><code>console.log(Bowser.parse(window.navigator.userAgent));
 
 // outputs
 {
@@ -103,9 +129,12 @@ console.log(impression.userTechData);
     name: &quot;Trident&quot;
     version: &quot;7.0&quot;
   }
-}</code></pre><h2>Filtering browsers</h2><p>You could want to filter some particular browsers to provide any special support for them or make any workarounds.
+}
+</code></pre>
+<h2>Filtering browsers</h2>
+<p>You could want to filter some particular browsers to provide any special support for them or make any workarounds.
 It could look like this:</p>
-<pre class="prettyprint source lang-javascript"><code>const browser = bowser.getParser(window.navigator.userAgent);
+<pre class="prettyprint source lang-javascript"><code>const browser = Bowser.getParser(window.navigator.userAgent);
 const isValidBrowser = browser.satisfies({
   // declare browsers per OS
   windows: {
@@ -124,27 +153,49 @@ const isValidBrowser = browser.satisfies({
   // or in general
   chrome: &quot;~20.1.1432&quot;,
   firefox: &quot;>31&quot;,
-  opera: &quot;>=22&quot;
+  opera: &quot;>=22&quot;,
 
   // also supports equality operator
   chrome: &quot;=20.1.1432&quot;, // will match particular build only
 
   // and loose-equality operator
-  chrome: &quot;~20&quot;         // will match any 20.* sub-version
+  chrome: &quot;~20&quot;,        // will match any 20.* sub-version
   chrome: &quot;~20.1&quot;       // will match any 20.1.* sub-version (20.1.19 as well as 20.1.12.42-alpha.1)
-});</code></pre><p>Settings for any particular OS or platform has more priority and redefines settings of standalone browsers.
+});
+</code></pre>
+<p>Settings for any particular OS or platform has more priority and redefines settings of standalone browsers.
 Thus, you can define OS or platform specific rules and they will have more priority in the end.</p>
 <p>More of API and possibilities you will find in the <code>docs</code> folder.</p>
-<h1>Contributing</h1><p>If you'd like to contribute a change to bowser, modify the files in <code>src/</code>, then run the following (you'll need node + npm installed):</p>
-<pre class="prettyprint source lang-sh"><code>$ npm install #build
-$ npm test #run tests
-$ npm run lint #check lint rules</code></pre><h3>Adding tests</h3><p>See the list in <code>test/acceptance/useragentstrings.yml</code> with example user agents and their expected bowser object.</p>
-<p>Whenever you add support for new browsers or notice a bug / mismatch, please update the list and
-check if all tests are still passing.</p>
-<h3>Similar Projects</h3><ul>
+<h3>Browser names for <code>.satisfies()</code></h3>
+<p>By default you are supposed to use the full browser name for <code>.satisfies</code>.
+But, there's a short way to define a browser using short aliases. The full
+list of aliases can be found in <a href="src/constants.js">the file</a>.</p>
+<h2>Similar Projects</h2>
+<ul>
 <li><a href="https://github.com/BigBadBleuCheese/Kong">Kong</a> - A C# port of Bowser.</li>
 </ul>
-<h3>License</h3><p>Licensed as MIT. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.</p></article>
+<h2>Contributors</h2>
+<h3>Code Contributors</h3>
+<p>This project exists thanks to all the people who contribute. [<a href="CONTRIBUTING.md">Contribute</a>].
+<a href="https://github.com/lancedikson/bowser/graphs/contributors"><img src="https://opencollective.com/bowser/contributors.svg?width=890&button=false" /></a></p>
+<h3>Financial Contributors</h3>
+<p>Become a financial contributor and help us sustain our community. [<a href="https://opencollective.com/bowser/contribute">Contribute</a>]</p>
+<h4>Individuals</h4>
+<p><a href="https://opencollective.com/bowser"><img src="https://opencollective.com/bowser/individuals.svg?width=890"></a></p>
+<h4>Organizations</h4>
+<p>Support this project with your organization. Your logo will show up here with a link to your website. [<a href="https://opencollective.com/bowser/contribute">Contribute</a>]</p>
+<p><a href="https://opencollective.com/bowser/organization/0/website"><img src="https://opencollective.com/bowser/organization/0/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/1/website"><img src="https://opencollective.com/bowser/organization/1/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/2/website"><img src="https://opencollective.com/bowser/organization/2/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/3/website"><img src="https://opencollective.com/bowser/organization/3/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/4/website"><img src="https://opencollective.com/bowser/organization/4/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/5/website"><img src="https://opencollective.com/bowser/organization/5/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/6/website"><img src="https://opencollective.com/bowser/organization/6/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/7/website"><img src="https://opencollective.com/bowser/organization/7/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/8/website"><img src="https://opencollective.com/bowser/organization/8/avatar.svg"></a>
+<a href="https://opencollective.com/bowser/organization/9/website"><img src="https://opencollective.com/bowser/organization/9/avatar.svg"></a></p>
+<h2>License</h2>
+<p>Licensed as MIT. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.</p></article>
     </section>
 
 
@@ -159,12 +210,14 @@ check if all tests are still passing.</p>
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sat Jan 19 2019 15:43:45 GMT+0200 (EET) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Sat Sep 12 2020 11:21:13 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
 <script src="scripts/linenumber.js"></script>
 
 
+
 </body>
 </html>

docs/parser.js.html

@@ -13,6 +13,7 @@
     <![endif]-->
     <link type="text/css" rel="stylesheet" href="styles/prettify.css">
     <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 </head>
 <body>
@@ -24,9 +25,9 @@
 
 <label for="nav-trigger" class="overlay"></label>
 
-<nav>
+<nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3><a href="global.html">Global</a></h3>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#assign">assign</a></li><li><a href="global.html#find">find</a></li><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getMacOSVersionName">getMacOSVersionName</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
 </nav>
 
 <div id="main">
@@ -41,11 +42,11 @@
     
     <section>
         <article>
-            <pre class="prettyprint source linenums"><code>import browserParsersList from './parser-browsers';
-import osParsersList from './parser-os';
-import platformParsersList from './parser-platforms';
-import enginesParsersList from './parser-engines';
-import { compareVersions } from './utils';
+            <pre class="prettyprint source linenums"><code>import browserParsersList from './parser-browsers.js';
+import osParsersList from './parser-os.js';
+import platformParsersList from './parser-platforms.js';
+import enginesParsersList from './parser-engines.js';
+import Utils from './utils.js';
 
 /**
  * The main class that arranges the whole parsing process.
@@ -125,7 +126,7 @@ class Parser {
   parseBrowser() {
     this.parsedResult.browser = {};
 
-    const browserDescriptor = browserParsersList.find((_browser) => {
+    const browserDescriptor = Utils.find(browserParsersList, (_browser) => {
       if (typeof _browser.test === 'function') {
         return _browser.test(this);
       }
@@ -208,7 +209,7 @@ class Parser {
   parseOS() {
     this.parsedResult.os = {};
 
-    const os = osParsersList.find((_os) => {
+    const os = Utils.find(osParsersList, (_os) => {
       if (typeof _os.test === 'function') {
         return _os.test(this);
       }
@@ -284,7 +285,7 @@ class Parser {
   parsePlatform() {
     this.parsedResult.platform = {};
 
-    const platform = platformParsersList.find((_platform) => {
+    const platform = Utils.find(platformParsersList, (_platform) => {
       if (typeof _platform.test === 'function') {
         return _platform.test(this);
       }
@@ -315,6 +316,19 @@ class Parser {
     return this.parseEngine();
   }
 
+  /**
+   * Get engines's name
+   * @return {String} Engines's name or an empty string
+   *
+   * @public
+   */
+  getEngineName(toLowerCase) {
+    if (toLowerCase) {
+      return String(this.getEngine().name).toLowerCase() || '';
+    }
+    return this.getEngine().name || '';
+  }
+
   /**
    * Get parsed platform
    * @return {{}}
@@ -322,7 +336,7 @@ class Parser {
   parseEngine() {
     this.parsedResult.engine = {};
 
-    const engine = enginesParsersList.find((_engine) => {
+    const engine = Utils.find(enginesParsersList, (_engine) => {
       if (typeof _engine.test === 'function') {
         return _engine.test(this);
       }
@@ -343,6 +357,7 @@ class Parser {
 
   /**
    * Parse full information about the browser
+   * @returns {Parser}
    */
   parse() {
     this.parseBrowser();
@@ -358,7 +373,7 @@ class Parser {
    * @return {ParsedResult}
    */
   getResult() {
-    return Object.assign({}, this.parsedResult);
+    return Utils.assign({}, this.parsedResult);
   }
 
   /**
@@ -372,12 +387,12 @@ class Parser {
    * Returns `undefined` when the browser is no described in the checkTree object.
    *
    * @example
-   * const browser = new Bowser(UA);
-   * if (browser.check({chrome: '>118.01.1322' }))
+   * const browser = Bowser.getParser(window.navigator.userAgent);
+   * if (browser.satisfies({chrome: '>118.01.1322' }))
    * // or with os
-   * if (browser.check({windows: { chrome: '>118.01.1322' } }))
+   * if (browser.satisfies({windows: { chrome: '>118.01.1322' } }))
    * // or with platforms
-   * if (browser.check({desktop: { chrome: '>118.01.1322' } }))
+   * if (browser.satisfies({desktop: { chrome: '>118.01.1322' } }))
    */
   satisfies(checkTree) {
     const platformsAndOSes = {};
@@ -400,7 +415,7 @@ class Parser {
 
     if (platformsAndOSCounter > 0) {
       const platformsAndOSNames = Object.keys(platformsAndOSes);
-      const OSMatchingDefinition = platformsAndOSNames.find(name => (this.isOS(name)));
+      const OSMatchingDefinition = Utils.find(platformsAndOSNames, name => (this.isOS(name)));
 
       if (OSMatchingDefinition) {
         const osResult = this.satisfies(platformsAndOSes[OSMatchingDefinition]);
@@ -410,7 +425,10 @@ class Parser {
         }
       }
 
-      const platformMatchingDefinition = platformsAndOSNames.find(name => (this.isPlatform(name)));
+      const platformMatchingDefinition = Utils.find(
+        platformsAndOSNames,
+        name => (this.isPlatform(name)),
+      );
       if (platformMatchingDefinition) {
         const platformResult = this.satisfies(platformsAndOSes[platformMatchingDefinition]);
 
@@ -422,7 +440,7 @@ class Parser {
 
     if (browsersCounter > 0) {
       const browserNames = Object.keys(browsers);
-      const matchingDefinition = browserNames.find(name => (this.isBrowser(name)));
+      const matchingDefinition = Utils.find(browserNames, name => (this.isBrowser(name, true)));
 
       if (matchingDefinition !== void 0) {
         return this.compareVersion(browsers[matchingDefinition]);
@@ -432,8 +450,21 @@ class Parser {
     return undefined;
   }
 
-  isBrowser(browserName) {
-    return this.getBrowserName(true) === String(browserName).toLowerCase();
+  /**
+   * Check if the browser name equals the passed string
+   * @param browserName The string to compare with the browser name
+   * @param [includingAlias=false] The flag showing whether alias will be included into comparison
+   * @returns {boolean}
+   */
+  isBrowser(browserName, includingAlias = false) {
+    const defaultBrowserName = this.getBrowserName().toLowerCase();
+    let browserNameLower = browserName.toLowerCase();
+    const alias = Utils.getBrowserTypeByAlias(browserNameLower);
+
+    if (includingAlias &amp;&amp; alias) {
+      browserNameLower = alias.toLowerCase();
+    }
+    return browserNameLower === defaultBrowserName;
   }
 
   compareVersion(version) {
@@ -468,7 +499,7 @@ class Parser {
     }
 
     return expectedResults.indexOf(
-      compareVersions(currentBrowserVersion, comparableVersion, isLoose),
+      Utils.compareVersions(currentBrowserVersion, comparableVersion, isLoose),
     ) > -1;
   }
 
@@ -480,14 +511,20 @@ class Parser {
     return this.getPlatformType(true) === String(platformType).toLowerCase();
   }
 
+  isEngine(engineName) {
+    return this.getEngineName(true) === String(engineName).toLowerCase();
+  }
+
   /**
    * Is anything? Check if the browser is called "anything",
    * the OS called "anything" or the platform called "anything"
    * @param {String} anything
+   * @param [includingAlias=false] The flag showing whether alias will be included into comparison
    * @returns {Boolean}
    */
-  is(anything) {
-    return this.isBrowser(anything) || this.isOS(anything) || this.isPlatform(anything);
+  is(anything, includingAlias = false) {
+    return this.isBrowser(anything, includingAlias) || this.isOS(anything)
+      || this.isPlatform(anything);
   }
 
   /**
@@ -515,12 +552,14 @@ export default Parser;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sat Jan 19 2019 15:43:45 GMT+0200 (EET) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Sat Sep 12 2020 11:21:13 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
 <script src="scripts/linenumber.js"></script>
 
 
+
 </body>
 </html>

docs/scripts/collapse.js

@@ -1,11 +1,20 @@
 function hideAllButCurrent(){
     //by default all submenut items are hidden
-    $("nav > ul > li > ul li").hide();
+    //but we need to rehide them for search
+    document.querySelectorAll("nav > ul > li > ul li").forEach(function(parent) {
+        parent.style.display = "none";
+    });
     
     //only current page (if it exists) should be opened
-    var file = window.location.pathname.split("/").pop();
-    $("nav > ul > li > a[href^='"+file+"']").parent().find("> ul li").show();
+    var file = window.location.pathname.split("/").pop().replace(/\.html/, '');
+    document.querySelectorAll("nav > ul > li > a").forEach(function(parent) {
+        var href = parent.attributes.href.value.replace(/\.html/, '');
+        if (file === href) {
+            parent.parentNode.querySelectorAll("ul li").forEach(function(elem) {
+                elem.style.display = "block";
+            });
+        }
+    });
 }
-$( document ).ready(function() {
-    hideAllButCurrent();
-});
+
+hideAllButCurrent();

docs/scripts/nav.js

@@ -0,0 +1,12 @@
+function scrollToNavItem() {
+    var path = window.location.href.split('/').pop().replace(/\.html/, '');
+    document.querySelectorAll('nav a').forEach(function(link) {
+      var href = link.attributes.href.value.replace(/\.html/, '');
+      if (path === href) {
+        link.scrollIntoView({block: 'center'});
+        return;
+      }
+    })
+  }
+
+  scrollToNavItem();

docs/scripts/polyfill.js

@@ -0,0 +1,4 @@
+//IE Fix, src: https://www.reddit.com/r/programminghorror/comments/6abmcr/nodelist_lacks_foreach_in_internet_explorer/
+if (typeof(NodeList.prototype.forEach)!==typeof(alert)){
+    NodeList.prototype.forEach=Array.prototype.forEach;
+}

docs/scripts/search.js

@@ -1,42 +1,83 @@
-$( document ).ready(function() {
-    jQuery.expr[':'].Contains = function(a,i,m){
-        return (a.textContent || a.innerText || "").toUpperCase().indexOf(m[3].toUpperCase())>=0;
-    };
-    //on search
-    $("#nav-search").on("keyup", function(event) {
-        var search = $(this).val();
-        if (!search) {
-            //no search, show all results
-            $("nav > ul > li").show();
-            
-            if(typeof hideAllButCurrent === "function"){
-                //let's do what ever collapse wants to do
-                hideAllButCurrent();
-            }
-            else{
-                //menu by default should be opened
-                $("nav > ul > li > ul li").show();
-            }
-        }
-        else{
-            //we are searching
-            //show all parents
-            $("nav > ul > li").show();
-            //hide all results
-            $("nav > ul > li > ul li").hide();
-            //show results matching filter
-            $("nav > ul > li > ul").find("a:Contains("+search+")").parent().show();
-            //hide parents without children
-            $("nav > ul > li").each(function(){
-                if($(this).find("a:Contains("+search+")").length == 0 && $(this).children("ul").length === 0){
-                    //has no child at all and does not contain text
-                    $(this).hide();
-                }
-                else if($(this).find("a:Contains("+search+")").length == 0 && $(this).find("ul").children(':visible').length == 0){
-                    //has no visible child and does not contain text
-                    $(this).hide();
-                }
+
+var searchAttr = 'data-search-mode';
+function contains(a,m){
+    return (a.textContent || a.innerText || "").toUpperCase().indexOf(m) !== -1;
+};
+
+//on search
+document.getElementById("nav-search").addEventListener("keyup", function(event) {
+    var search = this.value.toUpperCase();
+
+    if (!search) {
+        //no search, show all results
+        document.documentElement.removeAttribute(searchAttr);
+        
+        document.querySelectorAll("nav > ul > li:not(.level-hide)").forEach(function(elem) {
+            elem.style.display = "block";
+        });
+
+        if (typeof hideAllButCurrent === "function"){
+            //let's do what ever collapse wants to do
+            hideAllButCurrent();
+        } else {
+            //menu by default should be opened
+            document.querySelectorAll("nav > ul > li > ul li").forEach(function(elem) {
+                elem.style.display = "block";
             });
         }
-    });
+    } else {
+        //we are searching
+        document.documentElement.setAttribute(searchAttr, '');
+
+        //show all parents
+        document.querySelectorAll("nav > ul > li").forEach(function(elem) {
+            elem.style.display = "block";
+        });
+        //hide all results
+        document.querySelectorAll("nav > ul > li > ul li").forEach(function(elem) {
+            elem.style.display = "none";
+        });
+        //show results matching filter
+        document.querySelectorAll("nav > ul > li > ul a").forEach(function(elem) {
+            if (!contains(elem.parentNode, search)) {
+                return;
+            }
+            elem.parentNode.style.display = "block";
+        });
+        //hide parents without children
+        document.querySelectorAll("nav > ul > li").forEach(function(parent) {
+            var countSearchA = 0;
+            parent.querySelectorAll("a").forEach(function(elem) {
+                if (contains(elem, search)) {
+                    countSearchA++;
+                }
+            });
+            
+            var countUl = 0;
+            var countUlVisible = 0;
+            parent.querySelectorAll("ul").forEach(function(ulP) {
+                // count all elements that match the search
+                if (contains(ulP, search)) {
+                    countUl++;
+                }
+                
+                // count all visible elements
+                var children = ulP.children
+                for (i=0; i<children.length; i++) {
+                    var elem = children[i];
+                    if (elem.style.display != "none") {
+                        countUlVisible++;
+                    }
+                }
+            });
+          
+            if (countSearchA == 0 && countUl === 0){
+                //has no child at all and does not contain text
+                parent.style.display = "none";
+            } else if(countSearchA == 0 && countUlVisible == 0){
+                //has no visible child and does not contain text
+                parent.style.display = "none";
+            }
+        });
+    }
 });

docs/styles/jsdoc.css

@@ -16,7 +16,6 @@ body {
   padding: 0 20px;
   font-family: 'Helvetica Neue', Helvetica, sans-serif;
   font-size: 16px;
-  line-height: 160%;
 }
 
 img {
@@ -41,8 +40,13 @@ article a:hover, article a:active {
   border-bottom-color: #222;
 }
 
+article .description a {
+    word-break: break-word;
+}
+
 p, ul, ol, blockquote {
   margin-bottom: 1em;
+  line-height: 160%;
 }
 
 h1, h2, h3, h4, h5, h6 {
@@ -65,6 +69,7 @@ h1.page-title {
   font-size: 48px;
   margin: 1em 30px;
   line-height: 100%;
+  word-wrap: break-word;
 }
 
 h2 {
@@ -179,6 +184,10 @@ nav #nav-search{
     margin-top: 20px;
 }
 
+nav.wrap a{
+    word-wrap: break-word;
+}
+
 nav h3 {
   margin-top: 12px;
   font-size: 13px;
@@ -234,13 +243,12 @@ nav ul ul a:active {
 }
 
 nav h2 {
-   font-size: 12px;
-   margin: 0;
+   font-size: 13px;
+   margin: 10px 0 0 0;
    padding: 0;
 }
 
 nav > h2 > a {
-   display: block;
    margin: 10px 0 -10px;
    color: #606 !important;
 }
@@ -596,6 +604,15 @@ span.param-type, .params td .param-type, .param-type dd {
   z-index: 1;
 }
 
+/* nav level */
+.level-hide {
+    display: none;
+}
+html[data-search-mode] .level-hide {
+    display: block;
+}
+
+
 @media only screen and (min-width: 320px) and (max-width: 680px) {
   body {
     overflow-x: hidden;

docs/utils.js.html

@@ -13,6 +13,7 @@
     <![endif]-->
     <link type="text/css" rel="stylesheet" href="styles/prettify.css">
     <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
 </head>
 <body>
@@ -24,9 +25,9 @@
 
 <label for="nav-trigger" class="overlay"></label>
 
-<nav>
+<nav >
     
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3><a href="global.html">Global</a></h3>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Bowser.html">Bowser</a><ul class='methods'><li data-type='method'><a href="Bowser.html#.getParser">getParser</a></li><li data-type='method'><a href="Bowser.html#.parse">parse</a></li></ul></li><li><a href="Parser.html">Parser</a><ul class='methods'><li data-type='method'><a href="Parser.html#getBrowser">getBrowser</a></li><li data-type='method'><a href="Parser.html#getBrowserName">getBrowserName</a></li><li data-type='method'><a href="Parser.html#getBrowserVersion">getBrowserVersion</a></li><li data-type='method'><a href="Parser.html#getEngine">getEngine</a></li><li data-type='method'><a href="Parser.html#getEngineName">getEngineName</a></li><li data-type='method'><a href="Parser.html#getOS">getOS</a></li><li data-type='method'><a href="Parser.html#getOSName">getOSName</a></li><li data-type='method'><a href="Parser.html#getOSVersion">getOSVersion</a></li><li data-type='method'><a href="Parser.html#getPlatform">getPlatform</a></li><li data-type='method'><a href="Parser.html#getPlatformType">getPlatformType</a></li><li data-type='method'><a href="Parser.html#getResult">getResult</a></li><li data-type='method'><a href="Parser.html#getUA">getUA</a></li><li data-type='method'><a href="Parser.html#is">is</a></li><li data-type='method'><a href="Parser.html#isBrowser">isBrowser</a></li><li data-type='method'><a href="Parser.html#parse">parse</a></li><li data-type='method'><a href="Parser.html#parseBrowser">parseBrowser</a></li><li data-type='method'><a href="Parser.html#parseEngine">parseEngine</a></li><li data-type='method'><a href="Parser.html#parseOS">parseOS</a></li><li data-type='method'><a href="Parser.html#parsePlatform">parsePlatform</a></li><li data-type='method'><a href="Parser.html#satisfies">satisfies</a></li><li data-type='method'><a href="Parser.html#some">some</a></li><li data-type='method'><a href="Parser.html#test">test</a></li></ul></li></ul><h3>Global</h3><ul><li><a href="global.html#assign">assign</a></li><li><a href="global.html#find">find</a></li><li><a href="global.html#getAndroidVersionName">getAndroidVersionName</a></li><li><a href="global.html#getBrowserAlias">getBrowserAlias</a></li><li><a href="global.html#getBrowserTypeByAlias">getBrowserTypeByAlias</a></li><li><a href="global.html#getFirstMatch">getFirstMatch</a></li><li><a href="global.html#getMacOSVersionName">getMacOSVersionName</a></li><li><a href="global.html#getSecondMatch">getSecondMatch</a></li><li><a href="global.html#getVersionPrecision">getVersionPrecision</a></li><li><a href="global.html#map">map</a></li><li><a href="global.html#matchAndReturnConst">matchAndReturnConst</a></li></ul>
 </nav>
 
 <div id="main">
@@ -41,7 +42,9 @@
     
     <section>
         <article>
-            <pre class="prettyprint source linenums"><code>class Utils {
+            <pre class="prettyprint source linenums"><code>import { BROWSER_MAP, BROWSER_ALIASES_MAP } from './constants.js';
+
+export default class Utils {
   /**
    * Get first matched item for a string
    * @param {RegExp} regexp
@@ -94,6 +97,46 @@
     }
   }
 
+  /**
+   * Get macOS version name
+   *    10.5 - Leopard
+   *    10.6 - Snow Leopard
+   *    10.7 - Lion
+   *    10.8 - Mountain Lion
+   *    10.9 - Mavericks
+   *    10.10 - Yosemite
+   *    10.11 - El Capitan
+   *    10.12 - Sierra
+   *    10.13 - High Sierra
+   *    10.14 - Mojave
+   *    10.15 - Catalina
+   *
+   * @example
+   *   getMacOSVersionName("10.14") // 'Mojave'
+   *
+   * @param  {string} version
+   * @return {string} versionName
+   */
+  static getMacOSVersionName(version) {
+    const v = version.split('.').splice(0, 2).map(s => parseInt(s, 10) || 0);
+    v.push(0);
+    if (v[0] !== 10) return undefined;
+    switch (v[1]) {
+      case 5: return 'Leopard';
+      case 6: return 'Snow Leopard';
+      case 7: return 'Lion';
+      case 8: return 'Mountain Lion';
+      case 9: return 'Mavericks';
+      case 10: return 'Yosemite';
+      case 11: return 'El Capitan';
+      case 12: return 'Sierra';
+      case 13: return 'High Sierra';
+      case 14: return 'Mojave';
+      case 15: return 'Catalina';
+      default: return undefined;
+    }
+  }
+
   /**
    * Get Android version name
    *    1.5 - Cupcake
@@ -110,7 +153,7 @@
    *    6.x - Marshmallow
    *    7.x - Nougat
    *    8.x - Oreo
-   *    9.x - ?
+   *    9.x - Pie
    *
    * @example
    *   getAndroidVersionName("7.0") // 'Nougat'
@@ -135,6 +178,7 @@
     if (v[0] === 6) return 'Marshmallow';
     if (v[0] === 7) return 'Nougat';
     if (v[0] === 8) return 'Oreo';
+    if (v[0] === 9) return 'Pie';
     return undefined;
   }
 
@@ -210,6 +254,8 @@
         return -1;
       }
     }
+
+    return undefined;
   }
 
   /**
@@ -230,9 +276,81 @@
     }
     return result;
   }
-}
 
-module.exports = Utils;
+  /**
+   * Array::find polyfill
+   *
+   * @param  {Array} arr
+   * @param  {Function} predicate
+   * @return {Array}
+   */
+  static find(arr, predicate) {
+    let i;
+    let l;
+    if (Array.prototype.find) {
+      return Array.prototype.find.call(arr, predicate);
+    }
+    for (i = 0, l = arr.length; i &lt; l; i += 1) {
+      const value = arr[i];
+      if (predicate(value, i)) {
+        return value;
+      }
+    }
+    return undefined;
+  }
+
+  /**
+   * Object::assign polyfill
+   *
+   * @param  {Object} obj
+   * @param  {Object} ...objs
+   * @return {Object}
+   */
+  static assign(obj, ...assigners) {
+    const result = obj;
+    let i;
+    let l;
+    if (Object.assign) {
+      return Object.assign(obj, ...assigners);
+    }
+    for (i = 0, l = assigners.length; i &lt; l; i += 1) {
+      const assigner = assigners[i];
+      if (typeof assigner === 'object' &amp;&amp; assigner !== null) {
+        const keys = Object.keys(assigner);
+        keys.forEach((key) => {
+          result[key] = assigner[key];
+        });
+      }
+    }
+    return obj;
+  }
+
+  /**
+   * Get short version/alias for a browser name
+   *
+   * @example
+   *   getBrowserAlias('Microsoft Edge') // edge
+   *
+   * @param  {string} browserName
+   * @return {string}
+   */
+  static getBrowserAlias(browserName) {
+    return BROWSER_ALIASES_MAP[browserName];
+  }
+
+  /**
+   * Get short version/alias for a browser name
+   *
+   * @example
+   *   getBrowserAlias('edge') // Microsoft Edge
+   *
+   * @param  {string} browserAlias
+   * @return {string}
+   */
+  static getBrowserTypeByAlias(browserAlias) {
+    return BROWSER_MAP[browserAlias] || '';
+  }
+}
 </code></pre>
         </article>
     </section>
@@ -247,12 +365,14 @@ module.exports = Utils;
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sat Jan 19 2019 15:43:45 GMT+0200 (EET) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.6.3</a> on Sat Sep 12 2020 11:21:13 GMT+0300 (Eastern European Summer Time) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
 </footer>
 
 <script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
 <script src="scripts/linenumber.js"></script>
 
 
+
 </body>
 </html>

index.d.ts

@@ -2,223 +2,314 @@
 // Project: https://github.com/lancedikson/bowser
 // Definitions by: Alexander P. Cerutti <https://github.com/alexandercerutti>,
 
-export = Bowser;
+export default Bowser;
 export as namespace Bowser;
 
 declare namespace Bowser {
+  /**
+   * Creates a Parser instance
+   * @param {string} UA - User agent string
+   * @param {boolean} skipParsing
+   */
 
-	/**
-	 * Creates a Parser instance
-	 * @param {string} UA - User agent string
-	 * @param {boolean} skipParsing
-	 */
+  function getParser(UA: string, skipParsing?: boolean): Parser.Parser;
 
-	function getParser(UA: string, skipParsing?: boolean): Parser.Parser;
+  /**
+   * Creates a Parser instance and runs Parser.getResult immediately
+   * @param UA - User agent string
+   * @returns {Parser.ParsedResult}
+   */
 
-	/**
-	 * Creates a Parser instance and runs Parser.getResult immediately
-	 * @param UA - User agent string
-	 * @returns {Parser.ParsedResult}
-	 */
+  function parse(UA: string): Parser.ParsedResult;
 
-	function parse(UA: string): Parser.ParsedResult;
-}
-
-declare namespace Parser {
-	class Parser {
-		constructor(UA: string, skipParsing?: boolean);
-
-		/**
-		 * Get parsed browser object
-		 * @return {BrowserDetails} Browser's details
-		 */
-
-		getBrowser(): BrowserDetails;
-
-		/**
-		 * Get browser's name
-		 * @return {String} Browser's name or an empty string
-		 */
-
-		getBrowserName(): string;
-
-		/**
-		 * Get browser's version
-		 * @return {String} version of browser
-		 */
-
-		getBrowserVersion(): string;
-
-		/**
-		 * Get OS
-		 * @return {OSDetails} - OS Details
-		 *
-		 * @example
-		 * this.getOS(); // {
-		 * //   name: 'macOS',
-		 * //   version: '10.11.12',
-		 * // }
-		 */
-
-		getOS(): OSDetails;
-
-		/**
-		 * Get OS name
-		 * @param {Boolean} [toLowerCase] return lower-cased value
-		 * @return {String} name of the OS — macOS, Windows, Linux, etc.
-		 */
-
-		getOSName(toLowerCase?: boolean): string;
-
-		/**
-		 * Get OS version
-		 * @return {String} full version with dots ('10.11.12', '5.6', etc)
-		 */
-
-		getOSVersion(): string;
-
-		/**
-		 * Get parsed platform
-		 * @returns {PlatformDetails}
-		 */
-
-		getPlatform(): PlatformDetails;
-
-		/**
-		 * Get platform name
-		 * @param {boolean} toLowerCase
-		 */
-
-		getPlatformType(toLowerCase?: boolean): string;
-
-		/**
-		 * Get parsed engine
-		 * @returns {EngineDetails}
-		 */
-
-		getEngine(): EngineDetails;
-
-		/**
-		 * Get parsed result
-		 * @return {ParsedResult}
-		 */
-
-		getResult(): ParsedResult;
-
-		/**
-		 * Get UserAgent string of current Parser instance
-		 * @return {String} User-Agent String of the current <Parser> object
-		 */
-
-		getUA(): string;
-
-		/**
-		 * Is anything? Check if the browser is called "anything",
-		 * the OS called "anything" or the platform called "anything"
-		 * @param {String} anything
-		 * @returns {Boolean}
-		 */
-
-		is(anything: any): boolean;
-
-		/**
-		 * Parse full information about the browser
-		 */
-
-		parse(): void;
-
-		/**
-		 * Get parsed browser object
-		 * @returns {BrowserDetails}
-		 */
-
-		parseBrowser(): BrowserDetails;
-
-		/**
-		 * Get parsed engine
-		 * @returns {EngineDetails}
-		 */
-
-		parseEngine(): EngineDetails;
-
-		/**
-		 * Parse OS and save it to this.parsedResult.os
-		 * @returns {OSDetails}
-		 */
-
-		parseOS(): OSDetails;
-
-		/**
-		 * Get parsed platform
-		 * @returns {PlatformDetails}
-		 */
-
-		parsePlatform(): PlatformDetails;
-
-		/**
-		 * Check if parsed browser matches certain conditions
-		 *
-		 * @param {checkTree} checkTree It's one or two layered object,
-		 * which can include a platform or an OS on the first layer
-		 * and should have browsers specs on the bottom-laying layer
-		 *
-		 * @returns {Boolean|undefined} Whether the browser satisfies the set conditions or not.
-		 * Returns `undefined` when the browser is no described in the checkTree object.
-		 *
-		 * @example
-		 * const browser = new Bowser(UA);
-		 * if (browser.check({chrome: '>118.01.1322' }))
-		 * // or with os
-		 * if (browser.check({windows: { chrome: '>118.01.1322' } }))
-		 * // or with platforms
-		 * if (browser.check({desktop: { chrome: '>118.01.1322' } }))
-		 */
-
-		satisfies(checkTree: checkTree): boolean | undefined;
-
-		/**
-		 * Check if any of the given values satifies `.is(anything)`
-		 * @param {string[]} anythings
-		 * @returns {boolean} true if at least one condition is satisfied, false otherwise.
-		 */
-
-		some(anythings: string[]): boolean | undefined;
-
-		/**
-		 * Test a UA string for a regexp
-		 * @param regex
-		 * @returns {boolean} true if the regex matches the UA, false otherwise.
-		 */
-
-		test(regex: RegExp): boolean;
-	}
-
-	interface ParsedResult {
-		browser: BrowserDetails;
-		os: OSDetails;
-		platform: PlatformDetails;
-		engine: EngineDetails;
-	}
-
-	interface Details {
-		name?: string;
-		version?: string;
-	}
-
-	interface OSDetails extends Details {
-		versionName?: string;
-	}
-
-	interface PlatformDetails {
-		type?: string;
-		vendor?: string;
-		model?: string;
-	}
-
-	type BrowserDetails = Details;
-	type EngineDetails = Details;
-
-	interface checkTree {
-		[key: string]: any;
-	}
+  /**
+   * Constants exposed via bowser getters
+   */
+  const BROWSER_MAP: Record<string, string>;
+  const ENGINE_MAP: Record<string, string>;
+  const OS_MAP: Record<string, string>;
+  const PLATFORMS_MAP: Record<string, string>;
+
+  namespace Parser {
+    interface Parser {
+      constructor(UA: string, skipParsing?: boolean): Parser.Parser;
+
+      /**
+       * Check if the version is equals the browser version
+       * @param version The string to compare with the browser version
+       * @returns {boolean}
+       */
+
+      compareVersion(version: string): boolean;
+
+      /**
+       * Get parsed browser object
+       * @return {BrowserDetails} Browser's details
+       */
+
+      getBrowser(): BrowserDetails;
+
+      /**
+       * Get browser's name
+       * @param {Boolean} [toLowerCase] return lower-cased value
+       * @return {String} Browser's name or an empty string
+       */
+
+      getBrowserName(toLowerCase?: boolean): string;
+
+      /**
+       * Get browser's version
+       * @return {String} version of browser
+       */
+
+      getBrowserVersion(): string | undefined;
+
+      /**
+       * Get OS
+       * @return {OSDetails} - OS Details
+       *
+       * @example
+       * this.getOS(); // {
+       * //   name: 'macOS',
+       * //   version: '10.11.12',
+       * // }
+       */
+
+      getOS(): OSDetails;
+
+      /**
+       * Get OS name
+       * @param {Boolean} [toLowerCase] return lower-cased value
+       * @return {String} name of the OS — macOS, Windows, Linux, etc.
+       */
+
+      getOSName(toLowerCase?: boolean): string;
+
+      /**
+       * Get OS version
+       * @return {String} full version with dots ('10.11.12', '5.6', etc)
+       */
+
+      getOSVersion(): string;
+
+      /**
+       * Get parsed platform
+       * @returns {PlatformDetails}
+       */
+
+      getPlatform(): PlatformDetails;
+
+      /**
+       * Get platform name
+       * @param {boolean} toLowerCase
+       */
+
+      getPlatformType(toLowerCase?: boolean): string;
+
+      /**
+       * Get parsed engine
+       * @returns {EngineDetails}
+       */
+
+      getEngine(): EngineDetails;
+
+      /**
+       * Get parsed engine's name
+       * @returns {String} Engine's name or an empty string
+       */
+
+      getEngineName(): string;
+
+      /**
+       * Get parsed result
+       * @return {ParsedResult}
+       */
+
+      getResult(): ParsedResult;
+
+      /**
+       * Get UserAgent string of current Parser instance
+       * @return {String} User-Agent String of the current <Parser> object
+       */
+
+      getUA(): string;
+
+      /**
+       * Is anything? Check if the browser is called "anything",
+       * the OS called "anything" or the platform called "anything"
+       * @param {String} anything
+       * @param [includingAlias=false] The flag showing whether alias will be included into comparison
+       * @returns {Boolean}
+       */
+
+      is(anything: any, includingAlias?: boolean): boolean;
+
+      /**
+       * Check if the browser name equals the passed string
+       * @param browserName The string to compare with the browser name
+       * @param [includingAlias=false] The flag showing whether alias will be included into comparison
+       * @returns {boolean}
+       */
+
+      isBrowser(browserName: string, includingAlias?: boolean): boolean;
+
+      /**
+       * Check if the engine name equals the passed string
+       * @param engineName The string to compare with the engine name
+       * @returns {boolean}
+       */
+
+      isEngine(engineName: string): boolean;
+
+      /**
+       * Check if the OS name equals the passed string
+       * @param OSName The string to compare with the OS name
+       * @returns {boolean}
+       */
+
+      isOS(OSName: string): boolean;
+
+      /**
+       * Check if the platform name equals the passed string
+       * @param platformName The string to compare with the platform name
+       * @returns {boolean}
+       */
+
+      isPlatform(platformName: string): boolean;
+
+      /**
+       * Parse full information about the browser
+       * @returns {Parser.Parser}
+       */
+
+      parse(): Parser.Parser;
+
+      /**
+       * Get parsed browser object
+       * @returns {BrowserDetails}
+       */
+
+      parseBrowser(): BrowserDetails;
+
+      /**
+       * Get parsed engine
+       * @returns {EngineDetails}
+       */
+
+      parseEngine(): EngineDetails;
+
+      /**
+       * Parse OS and save it to this.parsedResult.os
+       * @returns {OSDetails}
+       */
+
+      parseOS(): OSDetails;
+
+      /**
+       * Get parsed platform
+       * @returns {PlatformDetails}
+       */
+
+      parsePlatform(): PlatformDetails;
+
+      /**
+       * Check if parsed browser matches certain conditions
+       *
+       * @param {checkTree} checkTree It's one or two layered object,
+       * which can include a platform or an OS on the first layer
+       * and should have browsers specs on the bottom-laying layer
+       *
+       * @returns {Boolean|undefined} Whether the browser satisfies the set conditions or not.
+       * Returns `undefined` when the browser is no described in the checkTree object.
+       *
+       * @example
+       * const browser = new Bowser(UA);
+       * if (browser.check({chrome: '>118.01.1322' }))
+       * // or with os
+       * if (browser.check({windows: { chrome: '>118.01.1322' } }))
+       * // or with platforms
+       * if (browser.check({desktop: { chrome: '>118.01.1322' } }))
+       */
+
+      satisfies(checkTree: checkTree): boolean | undefined;
+
+      /**
+       * Check if the browser name equals the passed string
+       * @param {string} browserName The string to compare with the browser name
+       * @param [includingAlias=false] The flag showing whether alias will be included into comparison
+       * @returns {boolean}
+       */
+
+      isBrowser(browserName: string, includingAlias?: boolean): boolean;
+
+      /**
+       * Check if the engine name equals the passed string
+       * @param {string} engineName The string to compare with the engine name
+       * @returns {boolean}
+       */
+
+      isEngine(engineName: string): boolean;
+
+      /**
+       * Check if the platform type equals the passed string
+       * @param {string} platformType The string to compare with the platform type
+       * @returns {boolean}
+       */
+
+      isPlatform(platformType: string): boolean;
+
+      /**
+       * Check if the OS name equals the passed string
+       * @param {string} osName The string to compare with the OS name
+       * @returns {boolean}
+       */
+
+      isOS(osName: string): boolean;
+
+      /**
+       * Check if any of the given values satisfies `.is(anything)`
+       * @param {string[]} anythings
+       * @returns {boolean} true if at least one condition is satisfied, false otherwise.
+       */
+
+      some(anythings: string[]): boolean | undefined;
+
+      /**
+       * Test a UA string for a regexp
+       * @param regex
+       * @returns {boolean} true if the regex matches the UA, false otherwise.
+       */
+
+      test(regex: RegExp): boolean;
+    }
+
+    interface ParsedResult {
+      browser: BrowserDetails;
+      os: OSDetails;
+      platform: PlatformDetails;
+      engine: EngineDetails;
+    }
+
+    interface Details {
+      name?: string;
+      version?: string;
+    }
+
+    interface OSDetails extends Details {
+      versionName?: string;
+    }
+
+    interface PlatformDetails {
+      type?: string;
+      vendor?: string;
+      model?: string;
+    }
+
+    type BrowserDetails = Details;
+    type EngineDetails = Details;
+
+    interface checkTree {
+      [key: string]: any;
+    }
+  }
 }

package.json

@@ -1,6 +1,5 @@
 {
   "name": "bowser",
-  "version": "2.1.0",
   "description": "Lightweight browser detector",
   "keywords": [
     "browser",
@@ -21,33 +20,39 @@
     }
   ],
   "main": "es5.js",
+  "browser": "es5.js",
+  "module": "src/bowser.js",
+  "types": "index.d.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lancedikson/bowser.git"
   },
   "devDependencies": {
-    "@babel/cli": "^7.2.3",
-    "@babel/core": "^7.2.2",
-    "@babel/polyfill": "^7.2.5",
-    "@babel/preset-env": "^7.2.3",
-    "@babel/register": "^7.0.0",
-    "ava": "^1.1.0",
-    "babel-eslint": "^10.0.1",
-    "babel-loader": "^8.0.5",
-    "babel-plugin-add-module-exports": "^1.0.0",
-    "babel-plugin-istanbul": "^5.1.1",
-    "coveralls": "^3.0.2",
-    "docdash": "^1.0.0",
-    "eslint": "^5.4.0",
-    "eslint-config-airbnb-base": "^13.1.0",
-    "eslint-plugin-ava": "^5.1.0",
-    "eslint-plugin-import": "^2.14.0",
-    "jsdoc": "^3.5.5",
-    "nyc": "^12.0.2",
-    "sinon": "^6.1.5",
-    "testem": "^2.9.3",
-    "webpack": "^4.28.4",
-    "webpack-cli": "^3.2.1",
+    "@babel/cli": "^7.11.6",
+    "@babel/core": "^7.8.0",
+    "@babel/polyfill": "^7.8.3",
+    "@babel/preset-env": "^7.8.2",
+    "@babel/register": "^7.8.3",
+    "ava": "^3.0.0",
+    "babel-eslint": "^10.0.3",
+    "babel-loader": "^8.0.6",
+    "babel-plugin-add-module-exports": "^1.0.2",
+    "babel-plugin-istanbul": "^6.0.0",
+    "compression-webpack-plugin": "^4.0.0",
+    "coveralls": "^3.0.6",
+    "docdash": "^1.1.1",
+    "eslint": "^6.5.1",
+    "eslint-config-airbnb-base": "^13.2.0",
+    "eslint-plugin-ava": "^10.0.0",
+    "eslint-plugin-import": "^2.18.2",
+    "gh-pages": "^3.0.0",
+    "jsdoc": "^3.6.3",
+    "nyc": "^15.0.0",
+    "sinon": "^9.0.0",
+    "testem": "^3.0.0",
+    "webpack": "^4.41.0",
+    "webpack-bundle-analyzer": "^3.5.2",
+    "webpack-cli": "^3.3.9",
     "yamljs": "^0.3.0"
   },
   "ava": {
@@ -63,13 +68,16 @@
   },
   "scripts": {
     "build": "webpack --config webpack.config.js",
+    "generate-and-deploy-docs": "npm run generate-docs && gh-pages --dist docs --dest docs",
+    "watch": "webpack --watch --config webpack.config.js",
     "prepublishOnly": "npm run build",
-    "lint": "eslint ./src",
+    "lint:check": "eslint ./src",
+    "lint:fix": "eslint --fix ./src",
     "testem": "testem",
     "test": "nyc --reporter=html --reporter=text ava",
     "test:watch": "ava --watch",
     "coverage": "nyc report --reporter=text-lcov | coveralls",
-    "docs": "jsdoc -c jsdoc.json"
+    "generate-docs": "jsdoc -c jsdoc.json"
   },
   "license": "MIT"
 }

src/bowser.js

@@ -2,9 +2,15 @@
  * Bowser - a browser detector
  * https://github.com/lancedikson/bowser
  * MIT License | (c) Dustin Diaz 2012-2015
- * MIT License | (c) Denis Demchenko 2015-2017
+ * MIT License | (c) Denis Demchenko 2015-2019
  */
-import Parser from './parser';
+import Parser from './parser.js';
+import {
+  BROWSER_MAP,
+  ENGINE_MAP,
+  OS_MAP,
+  PLATFORMS_MAP,
+} from './constants.js';
 
 /**
  * Bowser class.
@@ -12,13 +18,18 @@ import Parser from './parser';
  * It's supposed to work with collections of {@link Parser} instances
  * rather then solve one-instance problems.
  * All the one-instance stuff is located in Parser class.
+ *
+ * @class
+ * @classdesc Bowser is a static object, that provides an API to the Parsers
+ * @hideconstructor
  */
 class Bowser {
   /**
-   * Creates a {@link module:parser:Parser} instance
+   * Creates a {@link Parser} instance
    *
    * @param {String} UA UserAgent string
-   * @param {Boolean} [skipParsing=false] same as skipParsing for {@link Parser}
+   * @param {Boolean} [skipParsing=false] Will make the Parser postpone parsing until you ask it
+   * explicitly. Same as `skipParsing` for {@link Parser}.
    * @returns {Parser}
    * @throws {Error} when UA is not a String
    *
@@ -45,6 +56,22 @@ class Bowser {
   static parse(UA) {
     return (new Parser(UA)).getResult();
   }
+
+  static get BROWSER_MAP() {
+    return BROWSER_MAP;
+  }
+
+  static get ENGINE_MAP() {
+    return ENGINE_MAP;
+  }
+
+  static get OS_MAP() {
+    return OS_MAP;
+  }
+
+  static get PLATFORMS_MAP() {
+    return PLATFORMS_MAP;
+  }
 }
 
 export default Bowser;

src/constants.js

@@ -0,0 +1,119 @@
+// NOTE: this list must be up-to-date with browsers listed in
+// test/acceptance/useragentstrings.yml
+export const BROWSER_ALIASES_MAP = {
+  'Amazon Silk': 'amazon_silk',
+  'Android Browser': 'android',
+  Bada: 'bada',
+  BlackBerry: 'blackberry',
+  Chrome: 'chrome',
+  Chromium: 'chromium',
+  Electron: 'electron',
+  Epiphany: 'epiphany',
+  Firefox: 'firefox',
+  Focus: 'focus',
+  Generic: 'generic',
+  'Google Search': 'google_search',
+  Googlebot: 'googlebot',
+  'Internet Explorer': 'ie',
+  'K-Meleon': 'k_meleon',
+  Maxthon: 'maxthon',
+  'Microsoft Edge': 'edge',
+  'MZ Browser': 'mz',
+  'NAVER Whale Browser': 'naver',
+  Opera: 'opera',
+  'Opera Coast': 'opera_coast',
+  'Pale Moon': 'pale_moon',
+  PhantomJS: 'phantomjs',
+  Puffin: 'puffin',
+  QupZilla: 'qupzilla',
+  QQ: 'qq',
+  QQLite: 'qqlite',
+  Safari: 'safari',
+  Sailfish: 'sailfish',
+  'Samsung Internet for Android': 'samsung_internet',
+  SeaMonkey: 'seamonkey',
+  Sleipnir: 'sleipnir',
+  Swing: 'swing',
+  Tizen: 'tizen',
+  'UC Browser': 'uc',
+  Vivaldi: 'vivaldi',
+  'WebOS Browser': 'webos',
+  WeChat: 'wechat',
+  'Yandex Browser': 'yandex',
+  Roku: 'roku',
+};
+
+export const BROWSER_MAP = {
+  amazon_silk: 'Amazon Silk',
+  android: 'Android Browser',
+  bada: 'Bada',
+  blackberry: 'BlackBerry',
+  chrome: 'Chrome',
+  chromium: 'Chromium',
+  electron: 'Electron',
+  epiphany: 'Epiphany',
+  firefox: 'Firefox',
+  focus: 'Focus',
+  generic: 'Generic',
+  googlebot: 'Googlebot',
+  google_search: 'Google Search',
+  ie: 'Internet Explorer',
+  k_meleon: 'K-Meleon',
+  maxthon: 'Maxthon',
+  edge: 'Microsoft Edge',
+  mz: 'MZ Browser',
+  naver: 'NAVER Whale Browser',
+  opera: 'Opera',
+  opera_coast: 'Opera Coast',
+  pale_moon: 'Pale Moon',
+  phantomjs: 'PhantomJS',
+  puffin: 'Puffin',
+  qupzilla: 'QupZilla',
+  qq: 'QQ Browser',
+  qqlite: 'QQ Browser Lite',
+  safari: 'Safari',
+  sailfish: 'Sailfish',
+  samsung_internet: 'Samsung Internet for Android',
+  seamonkey: 'SeaMonkey',
+  sleipnir: 'Sleipnir',
+  swing: 'Swing',
+  tizen: 'Tizen',
+  uc: 'UC Browser',
+  vivaldi: 'Vivaldi',
+  webos: 'WebOS Browser',
+  wechat: 'WeChat',
+  yandex: 'Yandex Browser',
+};
+
+export const PLATFORMS_MAP = {
+  tablet: 'tablet',
+  mobile: 'mobile',
+  desktop: 'desktop',
+  tv: 'tv',
+  bot: 'bot',
+};
+
+export const OS_MAP = {
+  WindowsPhone: 'Windows Phone',
+  Windows: 'Windows',
+  MacOS: 'macOS',
+  iOS: 'iOS',
+  Android: 'Android',
+  WebOS: 'WebOS',
+  BlackBerry: 'BlackBerry',
+  Bada: 'Bada',
+  Tizen: 'Tizen',
+  Linux: 'Linux',
+  ChromeOS: 'Chrome OS',
+  PlayStation4: 'PlayStation 4',
+  Roku: 'Roku',
+};
+
+export const ENGINE_MAP = {
+  EdgeHTML: 'EdgeHTML',
+  Blink: 'Blink',
+  Trident: 'Trident',
+  Presto: 'Presto',
+  Gecko: 'Gecko',
+  WebKit: 'WebKit',
+};

src/parser-browsers.js

@@ -23,10 +23,7 @@
  * return true/false to get the Parser know if this browser descriptor matches the UA or not.
  */
 
-import {
-  getFirstMatch,
-  getSecondMatch,
-} from './utils';
+import Utils from './utils.js';
 
 const commonVersionIdentifier = /version\/(\d+(\.?_?\d+)+)/i;
 
@@ -38,7 +35,7 @@ const browsersList = [
       const browser = {
         name: 'Googlebot',
       };
-      const version = getFirstMatch(/googlebot\/(\d+(\.\d+))/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/googlebot\/(\d+(\.\d+))/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -55,7 +52,7 @@ const browsersList = [
       const browser = {
         name: 'Opera',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:opera)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:opera)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -72,7 +69,7 @@ const browsersList = [
       const browser = {
         name: 'Opera',
       };
-      const version = getFirstMatch(/(?:opr|opios)[\s/](\S+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:opr|opios)[\s/](\S+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -87,7 +84,7 @@ const browsersList = [
       const browser = {
         name: 'Samsung Internet for Android',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:SamsungBrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:SamsungBrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -102,7 +99,22 @@ const browsersList = [
       const browser = {
         name: 'NAVER Whale Browser',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:whale)[\s/](\d+(?:\.\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:whale)[\s/](\d+(?:\.\d+)+)/i, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/PaleMoon/i],
+    describe(ua) {
+      const browser = {
+        name: 'Pale Moon',
+      };
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:PaleMoon)[\s/](\d+(?:\.\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -117,7 +129,7 @@ const browsersList = [
       const browser = {
         name: 'MZ Browser',
       };
-      const version = getFirstMatch(/(?:MZBrowser)[\s/](\d+(?:\.\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:MZBrowser)[\s/](\d+(?:\.\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -132,7 +144,7 @@ const browsersList = [
       const browser = {
         name: 'Focus',
       };
-      const version = getFirstMatch(/(?:focus)[\s/](\d+(?:\.\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:focus)[\s/](\d+(?:\.\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -147,7 +159,7 @@ const browsersList = [
       const browser = {
         name: 'Swing',
       };
-      const version = getFirstMatch(/(?:swing)[\s/](\d+(?:\.\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:swing)[\s/](\d+(?:\.\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -162,7 +174,22 @@ const browsersList = [
       const browser = {
         name: 'Opera Coast',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:coast)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:coast)[\s/](\d+(\.?_?\d+)+)/i, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/opt\/\d+(?:.?_?\d+)+/i],
+    describe(ua) {
+      const browser = {
+        name: 'Opera Touch',
+      };
+      const version = Utils.getFirstMatch(/(?:opt)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -177,7 +204,7 @@ const browsersList = [
       const browser = {
         name: 'Yandex Browser',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:yabrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/(?:yabrowser)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -192,7 +219,7 @@ const browsersList = [
       const browser = {
         name: 'UC Browser',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:ucbrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:ucbrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -207,7 +234,7 @@ const browsersList = [
       const browser = {
         name: 'Maxthon',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:Maxthon|mxios)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:Maxthon|mxios)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -222,7 +249,7 @@ const browsersList = [
       const browser = {
         name: 'Epiphany',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:epiphany)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:epiphany)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -237,7 +264,7 @@ const browsersList = [
       const browser = {
         name: 'Puffin',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:puffin)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:puffin)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -252,7 +279,7 @@ const browsersList = [
       const browser = {
         name: 'Sleipnir',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:sleipnir)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:sleipnir)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -267,7 +294,7 @@ const browsersList = [
       const browser = {
         name: 'K-Meleon',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/(?:k-meleon)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:k-meleon)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -282,7 +309,22 @@ const browsersList = [
       const browser = {
         name: 'WeChat',
       };
-      const version = getFirstMatch(/(?:micromessenger)[\s/](\d+(\.?_?\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:micromessenger)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/qqbrowser/i],
+    describe(ua) {
+      const browser = {
+        name: (/qqbrowserlite/i).test(ua) ? 'QQ Browser Lite' : 'QQ Browser',
+      };
+      const version = Utils.getFirstMatch(/(?:qqbrowserlite|qqbrowser)[/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -297,7 +339,23 @@ const browsersList = [
       const browser = {
         name: 'Internet Explorer',
       };
-      const version = getFirstMatch(/(?:msie |rv:)(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/(?:msie |rv:)(\d+(\.?_?\d+)+)/i, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/\sedg\//i],
+    describe(ua) {
+      const browser = {
+        name: 'Microsoft Edge',
+      };
+
+      const version = Utils.getFirstMatch(/\sedg\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -313,7 +371,7 @@ const browsersList = [
         name: 'Microsoft Edge',
       };
 
-      const version = getSecondMatch(/edg([ea]|ios)\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getSecondMatch(/edg([ea]|ios)\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -328,7 +386,7 @@ const browsersList = [
       const browser = {
         name: 'Vivaldi',
       };
-      const version = getFirstMatch(/vivaldi\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/vivaldi\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -343,7 +401,7 @@ const browsersList = [
       const browser = {
         name: 'SeaMonkey',
       };
-      const version = getFirstMatch(/seamonkey\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/seamonkey\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -359,7 +417,7 @@ const browsersList = [
         name: 'Sailfish',
       };
 
-      const version = getFirstMatch(/sailfish\s?browser\/(\d+(\.\d+)?)/i, ua);
+      const version = Utils.getFirstMatch(/sailfish\s?browser\/(\d+(\.\d+)?)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -374,7 +432,7 @@ const browsersList = [
       const browser = {
         name: 'Amazon Silk',
       };
-      const version = getFirstMatch(/silk\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/silk\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -389,7 +447,7 @@ const browsersList = [
       const browser = {
         name: 'PhantomJS',
       };
-      const version = getFirstMatch(/phantomjs\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/phantomjs\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -404,7 +462,7 @@ const browsersList = [
       const browser = {
         name: 'SlimerJS',
       };
-      const version = getFirstMatch(/slimerjs\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/slimerjs\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -419,7 +477,7 @@ const browsersList = [
       const browser = {
         name: 'BlackBerry',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/blackberry[\d]+\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/blackberry[\d]+\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -434,7 +492,7 @@ const browsersList = [
       const browser = {
         name: 'WebOS Browser',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua) || getFirstMatch(/w(?:eb)?[o0]sbrowser\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/w(?:eb)?[o0]sbrowser\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -449,7 +507,7 @@ const browsersList = [
       const browser = {
         name: 'Bada',
       };
-      const version = getFirstMatch(/dolfin\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/dolfin\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -464,7 +522,7 @@ const browsersList = [
       const browser = {
         name: 'Tizen',
       };
-      const version = getFirstMatch(/(?:tizen\s?)?browser\/(\d+(\.?_?\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:tizen\s?)?browser\/(\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -479,7 +537,7 @@ const browsersList = [
       const browser = {
         name: 'QupZilla',
       };
-      const version = getFirstMatch(/(?:qupzilla)[\s/](\d+(\.?_?\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:qupzilla)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -494,7 +552,37 @@ const browsersList = [
       const browser = {
         name: 'Firefox',
       };
-      const version = getFirstMatch(/(?:firefox|iceweasel|fxios)[\s/](\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/(?:firefox|iceweasel|fxios)[\s/](\d+(\.?_?\d+)+)/i, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/electron/i],
+    describe(ua) {
+      const browser = {
+        name: 'Electron',
+      };
+      const version = Utils.getFirstMatch(/(?:electron)\/(\d+(\.?_?\d+)+)/i, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/MiuiBrowser/i],
+    describe(ua) {
+      const browser = {
+        name: 'Miui',
+      };
+      const version = Utils.getFirstMatch(/(?:MiuiBrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -509,7 +597,7 @@ const browsersList = [
       const browser = {
         name: 'Chromium',
       };
-      const version = getFirstMatch(/(?:chromium)[\s/](\d+(\.?_?\d+)+)/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(/(?:chromium)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -524,7 +612,22 @@ const browsersList = [
       const browser = {
         name: 'Chrome',
       };
-      const version = getFirstMatch(/(?:chrome|crios|crmo)\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/(?:chrome|crios|crmo)\/(\d+(\.?_?\d+)+)/i, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/GSA/i],
+    describe(ua) {
+      const browser = {
+        name: 'Google Search',
+      };
+      const version = Utils.getFirstMatch(/(?:GSA)\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         browser.version = version;
@@ -545,7 +648,24 @@ const browsersList = [
       const browser = {
         name: 'Android Browser',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+
+  /* PlayStation 4 */
+  {
+    test: [/playstation 4/i],
+    describe(ua) {
+      const browser = {
+        name: 'PlayStation 4',
+      };
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -562,7 +682,7 @@ const browsersList = [
       const browser = {
         name: 'Safari',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -576,9 +696,17 @@ const browsersList = [
   {
     test: [/.*/i],
     describe(ua) {
+      /* Here we try to make sure that there are explicit details about the device
+       * in order to decide what regexp exactly we want to apply
+       * (as there is a specific decision based on that conclusion)
+       */
+      const regexpWithoutDeviceSpec = /^(.*)\/(.*) /;
+      const regexpWithDeviceSpec = /^(.*)\/(.*)[ \t]\((.*)/;
+      const hasDeviceSpec = ua.search('\\(') !== -1;
+      const regexp = hasDeviceSpec ? regexpWithDeviceSpec : regexpWithoutDeviceSpec;
       return {
-        name: getFirstMatch(/^(.*)\/(.*) /, ua),
-        version: getSecondMatch(/^(.*)\/(.*) /, ua),
+        name: Utils.getFirstMatch(regexp, ua),
+        version: Utils.getSecondMatch(regexp, ua),
       };
     },
   },

src/parser-engines.js

@@ -1,4 +1,5 @@
-import { getFirstMatch } from './utils';
+import Utils from './utils.js';
+import { ENGINE_MAP } from './constants.js';
 
 /*
  * More specific goes first
@@ -10,9 +11,20 @@ export default [
       return parser.getBrowserName(true) === 'microsoft edge';
     },
     describe(ua) {
-      const version = getFirstMatch(/edge\/(\d+(\.?_?\d+)+)/i, ua);
+      const isBlinkBased = /\sedg\//i.test(ua);
+
+      // return blink if it's blink-based one
+      if (isBlinkBased) {
+        return {
+          name: ENGINE_MAP.Blink,
+        };
+      }
+
+      // otherwise match the version and return EdgeHTML
+      const version = Utils.getFirstMatch(/edge\/(\d+(\.?_?\d+)+)/i, ua);
+
       return {
-        name: 'EdgeHTML',
+        name: ENGINE_MAP.EdgeHTML,
         version,
       };
     },
@@ -23,10 +35,10 @@ export default [
     test: [/trident/i],
     describe(ua) {
       const engine = {
-        name: 'Trident',
+        name: ENGINE_MAP.Trident,
       };
 
-      const version = getFirstMatch(/trident\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/trident\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         engine.version = version;
@@ -43,10 +55,10 @@ export default [
     },
     describe(ua) {
       const engine = {
-        name: 'Presto',
+        name: ENGINE_MAP.Presto,
       };
 
-      const version = getFirstMatch(/presto\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/presto\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         engine.version = version;
@@ -65,10 +77,10 @@ export default [
     },
     describe(ua) {
       const engine = {
-        name: 'Gecko',
+        name: ENGINE_MAP.Gecko,
       };
 
-      const version = getFirstMatch(/gecko\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/gecko\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         engine.version = version;
@@ -83,7 +95,7 @@ export default [
     test: [/(apple)?webkit\/537\.36/i],
     describe() {
       return {
-        name: 'Blink',
+        name: ENGINE_MAP.Blink,
       };
     },
   },
@@ -93,10 +105,10 @@ export default [
     test: [/(apple)?webkit/i],
     describe(ua) {
       const engine = {
-        name: 'WebKit',
+        name: ENGINE_MAP.WebKit,
       };
 
-      const version = getFirstMatch(/webkit\/(\d+(\.?_?\d+)+)/i, ua);
+      const version = Utils.getFirstMatch(/webkit\/(\d+(\.?_?\d+)+)/i, ua);
 
       if (version) {
         engine.version = version;

src/parser-os.js

@@ -1,17 +1,26 @@
-import {
-  getFirstMatch,
-  getWindowsVersionName,
-  getAndroidVersionName,
-} from './utils';
+import Utils from './utils.js';
+import { OS_MAP } from './constants.js';
 
 export default [
+  /* Roku */
+  {
+    test: [/Roku\/DVP/],
+    describe(ua) {
+      const version = Utils.getFirstMatch(/Roku\/DVP-(\d+\.\d+)/i, ua);
+      return {
+        name: OS_MAP.Roku,
+        version,
+      };
+    },
+  },
+
   /* Windows Phone */
   {
     test: [/windows phone/i],
     describe(ua) {
-      const version = getFirstMatch(/windows phone (?:os)?\s?(\d+(\.\d+)*)/i, ua);
+      const version = Utils.getFirstMatch(/windows phone (?:os)?\s?(\d+(\.\d+)*)/i, ua);
       return {
-        name: 'Windows Phone',
+        name: OS_MAP.WindowsPhone,
         version,
       };
     },
@@ -19,28 +28,49 @@ export default [
 
   /* Windows */
   {
-    test: [/windows/i],
+    test: [/windows /i],
     describe(ua) {
-      const version = getFirstMatch(/Windows ((NT|XP)( \d\d?.\d)?)/i, ua);
-      const versionName = getWindowsVersionName(version);
+      const version = Utils.getFirstMatch(/Windows ((NT|XP)( \d\d?.\d)?)/i, ua);
+      const versionName = Utils.getWindowsVersionName(version);
 
       return {
-        name: 'Windows',
+        name: OS_MAP.Windows,
         version,
         versionName,
       };
     },
   },
 
+  /* Firefox on iPad */
+  {
+    test: [/Macintosh(.*?) FxiOS(.*?)\//],
+    describe(ua) {
+      const result = {
+        name: OS_MAP.iOS,
+      };
+      const version = Utils.getSecondMatch(/(Version\/)(\d[\d.]+)/, ua);
+      if (version) {
+        result.version = version;
+      }
+      return result;
+    },
+  },
+
   /* macOS */
   {
     test: [/macintosh/i],
     describe(ua) {
-      const version = getFirstMatch(/mac os x (\d+(\.?_?\d+)+)/i, ua).replace(/[_\s]/g, '.');
-      return {
-        name: 'macOS',
+      const version = Utils.getFirstMatch(/mac os x (\d+(\.?_?\d+)+)/i, ua).replace(/[_\s]/g, '.');
+      const versionName = Utils.getMacOSVersionName(version);
+
+      const os = {
+        name: OS_MAP.MacOS,
         version,
       };
+      if (versionName) {
+        os.versionName = versionName;
+      }
+      return os;
     },
   },
 
@@ -48,10 +78,10 @@ export default [
   {
     test: [/(ipod|iphone|ipad)/i],
     describe(ua) {
-      const version = getFirstMatch(/os (\d+([_\s]\d+)*) like mac os x/i, ua).replace(/[_\s]/g, '.');
+      const version = Utils.getFirstMatch(/os (\d+([_\s]\d+)*) like mac os x/i, ua).replace(/[_\s]/g, '.');
 
       return {
-        name: 'iOS',
+        name: OS_MAP.iOS,
         version,
       };
     },
@@ -65,10 +95,10 @@ export default [
       return notLikeAndroid && butAndroid;
     },
     describe(ua) {
-      const version = getFirstMatch(/android[\s/-](\d+(\.\d+)*)/i, ua);
-      const versionName = getAndroidVersionName(version);
+      const version = Utils.getFirstMatch(/android[\s/-](\d+(\.\d+)*)/i, ua);
+      const versionName = Utils.getAndroidVersionName(version);
       const os = {
-        name: 'Android',
+        name: OS_MAP.Android,
         version,
       };
       if (versionName) {
@@ -82,9 +112,9 @@ export default [
   {
     test: [/(web|hpw)[o0]s/i],
     describe(ua) {
-      const version = getFirstMatch(/(?:web|hpw)[o0]s\/(\d+(\.\d+)*)/i, ua);
+      const version = Utils.getFirstMatch(/(?:web|hpw)[o0]s\/(\d+(\.\d+)*)/i, ua);
       const os = {
-        name: 'WebOS',
+        name: OS_MAP.WebOS,
       };
 
       if (version && version.length) {
@@ -98,12 +128,12 @@ export default [
   {
     test: [/blackberry|\bbb\d+/i, /rim\stablet/i],
     describe(ua) {
-      const version = getFirstMatch(/rim\stablet\sos\s(\d+(\.\d+)*)/i, ua)
-        || getFirstMatch(/blackberry\d+\/(\d+([_\s]\d+)*)/i, ua)
-        || getFirstMatch(/\bbb(\d+)/i, ua);
+      const version = Utils.getFirstMatch(/rim\stablet\sos\s(\d+(\.\d+)*)/i, ua)
+        || Utils.getFirstMatch(/blackberry\d+\/(\d+([_\s]\d+)*)/i, ua)
+        || Utils.getFirstMatch(/\bbb(\d+)/i, ua);
 
       return {
-        name: 'BlackBerry',
+        name: OS_MAP.BlackBerry,
         version,
       };
     },
@@ -113,10 +143,10 @@ export default [
   {
     test: [/bada/i],
     describe(ua) {
-      const version = getFirstMatch(/bada\/(\d+(\.\d+)*)/i, ua);
+      const version = Utils.getFirstMatch(/bada\/(\d+(\.\d+)*)/i, ua);
 
       return {
-        name: 'Bada',
+        name: OS_MAP.Bada,
         version,
       };
     },
@@ -126,10 +156,10 @@ export default [
   {
     test: [/tizen/i],
     describe(ua) {
-      const version = getFirstMatch(/tizen[/\s](\d+(\.\d+)*)/i, ua);
+      const version = Utils.getFirstMatch(/tizen[/\s](\d+(\.\d+)*)/i, ua);
 
       return {
-        name: 'Tizen',
+        name: OS_MAP.Tizen,
         version,
       };
     },
@@ -140,7 +170,7 @@ export default [
     test: [/linux/i],
     describe() {
       return {
-        name: 'Linux',
+        name: OS_MAP.Linux,
       };
     },
   },
@@ -150,7 +180,19 @@ export default [
     test: [/CrOS/],
     describe() {
       return {
-        name: 'Chrome OS',
+        name: OS_MAP.ChromeOS,
+      };
+    },
+  },
+
+  /* Playstation 4 */
+  {
+    test: [/PlayStation 4/],
+    describe(ua) {
+      const version = Utils.getFirstMatch(/PlayStation 4[/\s](\d+(\.\d+)*)/i, ua);
+      return {
+        name: OS_MAP.PlayStation4,
+        version,
       };
     },
   },

src/parser-platforms.js

@@ -1,10 +1,5 @@
-import { getFirstMatch } from './utils';
-
-const TYPES_LABELS = {
-  tablet: 'tablet',
-  mobile: 'mobile',
-  desktop: 'desktop',
-};
+import Utils from './utils.js';
+import { PLATFORMS_MAP } from './constants.js';
 
 /*
  * Tablets go first since usually they have more specific
@@ -17,7 +12,7 @@ export default [
     test: [/googlebot/i],
     describe() {
       return {
-        type: 'bot',
+        type: PLATFORMS_MAP.bot,
         vendor: 'Google',
       };
     },
@@ -27,9 +22,9 @@ export default [
   {
     test: [/huawei/i],
     describe(ua) {
-      const model = getFirstMatch(/(can-l01)/i, ua) && 'Nova';
+      const model = Utils.getFirstMatch(/(can-l01)/i, ua) && 'Nova';
       const platform = {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'Huawei',
       };
       if (model) {
@@ -44,7 +39,7 @@ export default [
     test: [/nexus\s*(?:7|8|9|10).*/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
         vendor: 'Nexus',
       };
     },
@@ -55,7 +50,19 @@ export default [
     test: [/ipad/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
+        vendor: 'Apple',
+        model: 'iPad',
+      };
+    },
+  },
+
+  /* Firefox on iPad */
+  {
+    test: [/Macintosh(.*?) FxiOS(.*?)\//],
+    describe() {
+      return {
+        type: PLATFORMS_MAP.tablet,
         vendor: 'Apple',
         model: 'iPad',
       };
@@ -67,7 +74,7 @@ export default [
     test: [/kftt build/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
         vendor: 'Amazon',
         model: 'Kindle Fire HD 7',
       };
@@ -79,7 +86,7 @@ export default [
     test: [/silk/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
         vendor: 'Amazon',
       };
     },
@@ -87,10 +94,10 @@ export default [
 
   /* Tablet */
   {
-    test: [/tablet/i],
+    test: [/tablet(?! pc)/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
       };
     },
   },
@@ -103,9 +110,9 @@ export default [
       return iDevice && !likeIDevice;
     },
     describe(ua) {
-      const model = getFirstMatch(/(ipod|iphone)/i, ua);
+      const model = Utils.getFirstMatch(/(ipod|iphone)/i, ua);
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'Apple',
         model,
       };
@@ -117,18 +124,34 @@ export default [
     test: [/nexus\s*[0-6].*/i, /galaxy nexus/i],
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'Nexus',
       };
     },
   },
 
+  /* Nokia */
+  {
+    test: [/Nokia/i],
+    describe(ua) {
+      const model = Utils.getFirstMatch(/Nokia\s+([0-9]+(\.[0-9]+)?)/i, ua);
+      const platform = {
+        type: PLATFORMS_MAP.mobile,
+        vendor: 'Nokia',
+      };
+      if (model) {
+        platform.model = model;
+      }
+      return platform;
+    },
+  },
+
   /* Mobile */
   {
     test: [/[^-]mobi/i],
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
       };
     },
   },
@@ -140,7 +163,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'BlackBerry',
       };
     },
@@ -153,7 +176,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
       };
     },
   },
@@ -165,7 +188,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'Microsoft',
       };
     },
@@ -179,7 +202,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
       };
     },
   },
@@ -191,7 +214,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
       };
     },
   },
@@ -203,7 +226,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.desktop,
+        type: PLATFORMS_MAP.desktop,
         vendor: 'Apple',
       };
     },
@@ -216,7 +239,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.desktop,
+        type: PLATFORMS_MAP.desktop,
       };
     },
   },
@@ -228,7 +251,31 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.desktop,
+        type: PLATFORMS_MAP.desktop,
+      };
+    },
+  },
+
+  /* PlayStation 4 */
+  {
+    test(parser) {
+      return parser.getOSName(true) === 'playstation 4';
+    },
+    describe() {
+      return {
+        type: PLATFORMS_MAP.tv,
+      };
+    },
+  },
+
+  /* Roku */
+  {
+    test(parser) {
+      return parser.getOSName(true) === 'roku';
+    },
+    describe() {
+      return {
+        type: PLATFORMS_MAP.tv,
       };
     },
   },

src/parser.js

@@ -1,8 +1,8 @@
-import browserParsersList from './parser-browsers';
-import osParsersList from './parser-os';
-import platformParsersList from './parser-platforms';
-import enginesParsersList from './parser-engines';
-import { compareVersions } from './utils';
+import browserParsersList from './parser-browsers.js';
+import osParsersList from './parser-os.js';
+import platformParsersList from './parser-platforms.js';
+import enginesParsersList from './parser-engines.js';
+import Utils from './utils.js';
 
 /**
  * The main class that arranges the whole parsing process.
@@ -82,12 +82,12 @@ class Parser {
   parseBrowser() {
     this.parsedResult.browser = {};
 
-    const browserDescriptor = browserParsersList.find((_browser) => {
+    const browserDescriptor = Utils.find(browserParsersList, (_browser) => {
       if (typeof _browser.test === 'function') {
         return _browser.test(this);
       }
 
-      if (_browser.test instanceof Array) {
+      if (Array.isArray(_browser.test)) {
         return _browser.test.some(condition => this.test(condition));
       }
 
@@ -165,12 +165,12 @@ class Parser {
   parseOS() {
     this.parsedResult.os = {};
 
-    const os = osParsersList.find((_os) => {
+    const os = Utils.find(osParsersList, (_os) => {
       if (typeof _os.test === 'function') {
         return _os.test(this);
       }
 
-      if (_os.test instanceof Array) {
+      if (Array.isArray(_os.test)) {
         return _os.test.some(condition => this.test(condition));
       }
 
@@ -241,12 +241,12 @@ class Parser {
   parsePlatform() {
     this.parsedResult.platform = {};
 
-    const platform = platformParsersList.find((_platform) => {
+    const platform = Utils.find(platformParsersList, (_platform) => {
       if (typeof _platform.test === 'function') {
         return _platform.test(this);
       }
 
-      if (_platform.test instanceof Array) {
+      if (Array.isArray(_platform.test)) {
         return _platform.test.some(condition => this.test(condition));
       }
 
@@ -292,12 +292,12 @@ class Parser {
   parseEngine() {
     this.parsedResult.engine = {};
 
-    const engine = enginesParsersList.find((_engine) => {
+    const engine = Utils.find(enginesParsersList, (_engine) => {
       if (typeof _engine.test === 'function') {
         return _engine.test(this);
       }
 
-      if (_engine.test instanceof Array) {
+      if (Array.isArray(_engine.test)) {
         return _engine.test.some(condition => this.test(condition));
       }
 
@@ -313,6 +313,7 @@ class Parser {
 
   /**
    * Parse full information about the browser
+   * @returns {Parser}
    */
   parse() {
     this.parseBrowser();
@@ -328,7 +329,7 @@ class Parser {
    * @return {ParsedResult}
    */
   getResult() {
-    return Object.assign({}, this.parsedResult);
+    return Utils.assign({}, this.parsedResult);
   }
 
   /**
@@ -342,12 +343,12 @@ class Parser {
    * Returns `undefined` when the browser is no described in the checkTree object.
    *
    * @example
-   * const browser = new Bowser(UA);
-   * if (browser.check({chrome: '>118.01.1322' }))
+   * const browser = Bowser.getParser(window.navigator.userAgent);
+   * if (browser.satisfies({chrome: '>118.01.1322' }))
    * // or with os
-   * if (browser.check({windows: { chrome: '>118.01.1322' } }))
+   * if (browser.satisfies({windows: { chrome: '>118.01.1322' } }))
    * // or with platforms
-   * if (browser.check({desktop: { chrome: '>118.01.1322' } }))
+   * if (browser.satisfies({desktop: { chrome: '>118.01.1322' } }))
    */
   satisfies(checkTree) {
     const platformsAndOSes = {};
@@ -370,7 +371,7 @@ class Parser {
 
     if (platformsAndOSCounter > 0) {
       const platformsAndOSNames = Object.keys(platformsAndOSes);
-      const OSMatchingDefinition = platformsAndOSNames.find(name => (this.isOS(name)));
+      const OSMatchingDefinition = Utils.find(platformsAndOSNames, name => (this.isOS(name)));
 
       if (OSMatchingDefinition) {
         const osResult = this.satisfies(platformsAndOSes[OSMatchingDefinition]);
@@ -380,7 +381,10 @@ class Parser {
         }
       }
 
-      const platformMatchingDefinition = platformsAndOSNames.find(name => (this.isPlatform(name)));
+      const platformMatchingDefinition = Utils.find(
+        platformsAndOSNames,
+        name => (this.isPlatform(name)),
+      );
       if (platformMatchingDefinition) {
         const platformResult = this.satisfies(platformsAndOSes[platformMatchingDefinition]);
 
@@ -392,7 +396,7 @@ class Parser {
 
     if (browsersCounter > 0) {
       const browserNames = Object.keys(browsers);
-      const matchingDefinition = browserNames.find(name => (this.isBrowser(name)));
+      const matchingDefinition = Utils.find(browserNames, name => (this.isBrowser(name, true)));
 
       if (matchingDefinition !== void 0) {
         return this.compareVersion(browsers[matchingDefinition]);
@@ -402,8 +406,21 @@ class Parser {
     return undefined;
   }
 
-  isBrowser(browserName) {
-    return this.getBrowserName(true) === String(browserName).toLowerCase();
+  /**
+   * Check if the browser name equals the passed string
+   * @param {string} browserName The string to compare with the browser name
+   * @param [includingAlias=false] The flag showing whether alias will be included into comparison
+   * @returns {boolean}
+   */
+  isBrowser(browserName, includingAlias = false) {
+    const defaultBrowserName = this.getBrowserName().toLowerCase();
+    let browserNameLower = browserName.toLowerCase();
+    const alias = Utils.getBrowserTypeByAlias(browserNameLower);
+
+    if (includingAlias && alias) {
+      browserNameLower = alias.toLowerCase();
+    }
+    return browserNameLower === defaultBrowserName;
   }
 
   compareVersion(version) {
@@ -438,18 +455,33 @@ class Parser {
     }
 
     return expectedResults.indexOf(
-      compareVersions(currentBrowserVersion, comparableVersion, isLoose),
+      Utils.compareVersions(currentBrowserVersion, comparableVersion, isLoose),
     ) > -1;
   }
 
+  /**
+   * Check if the OS name equals the passed string
+   * @param {string} osName The string to compare with the OS name
+   * @returns {boolean}
+   */
   isOS(osName) {
     return this.getOSName(true) === String(osName).toLowerCase();
   }
 
+  /**
+   * Check if the platform type equals the passed string
+   * @param {string} platformType The string to compare with the platform type
+   * @returns {boolean}
+   */
   isPlatform(platformType) {
     return this.getPlatformType(true) === String(platformType).toLowerCase();
   }
 
+  /**
+   * Check if the engine name equals the passed string
+   * @param {string} engineName The string to compare with the engine name
+   * @returns {boolean}
+   */
   isEngine(engineName) {
     return this.getEngineName(true) === String(engineName).toLowerCase();
   }
@@ -458,10 +490,12 @@ class Parser {
    * Is anything? Check if the browser is called "anything",
    * the OS called "anything" or the platform called "anything"
    * @param {String} anything
+   * @param [includingAlias=false] The flag showing whether alias will be included into comparison
    * @returns {Boolean}
    */
-  is(anything) {
-    return this.isBrowser(anything) || this.isOS(anything) || this.isPlatform(anything);
+  is(anything, includingAlias = false) {
+    return this.isBrowser(anything, includingAlias) || this.isOS(anything)
+      || this.isPlatform(anything);
   }
 
   /**

src/utils.js

@@ -1,4 +1,6 @@
-class Utils {
+import { BROWSER_MAP, BROWSER_ALIASES_MAP } from './constants.js';
+
+export default class Utils {
   /**
    * Get first matched item for a string
    * @param {RegExp} regexp
@@ -51,6 +53,46 @@ class Utils {
     }
   }
 
+  /**
+   * Get macOS version name
+   *    10.5 - Leopard
+   *    10.6 - Snow Leopard
+   *    10.7 - Lion
+   *    10.8 - Mountain Lion
+   *    10.9 - Mavericks
+   *    10.10 - Yosemite
+   *    10.11 - El Capitan
+   *    10.12 - Sierra
+   *    10.13 - High Sierra
+   *    10.14 - Mojave
+   *    10.15 - Catalina
+   *
+   * @example
+   *   getMacOSVersionName("10.14") // 'Mojave'
+   *
+   * @param  {string} version
+   * @return {string} versionName
+   */
+  static getMacOSVersionName(version) {
+    const v = version.split('.').splice(0, 2).map(s => parseInt(s, 10) || 0);
+    v.push(0);
+    if (v[0] !== 10) return undefined;
+    switch (v[1]) {
+      case 5: return 'Leopard';
+      case 6: return 'Snow Leopard';
+      case 7: return 'Lion';
+      case 8: return 'Mountain Lion';
+      case 9: return 'Mavericks';
+      case 10: return 'Yosemite';
+      case 11: return 'El Capitan';
+      case 12: return 'Sierra';
+      case 13: return 'High Sierra';
+      case 14: return 'Mojave';
+      case 15: return 'Catalina';
+      default: return undefined;
+    }
+  }
+
   /**
    * Get Android version name
    *    1.5 - Cupcake
@@ -67,7 +109,7 @@ class Utils {
    *    6.x - Marshmallow
    *    7.x - Nougat
    *    8.x - Oreo
-   *    9.x - ?
+   *    9.x - Pie
    *
    * @example
    *   getAndroidVersionName("7.0") // 'Nougat'
@@ -92,6 +134,7 @@ class Utils {
     if (v[0] === 6) return 'Marshmallow';
     if (v[0] === 7) return 'Nougat';
     if (v[0] === 8) return 'Oreo';
+    if (v[0] === 9) return 'Pie';
     return undefined;
   }
 
@@ -167,6 +210,8 @@ class Utils {
         return -1;
       }
     }
+
+    return undefined;
   }
 
   /**
@@ -187,6 +232,78 @@ class Utils {
     }
     return result;
   }
-}
 
-module.exports = Utils;
+  /**
+   * Array::find polyfill
+   *
+   * @param  {Array} arr
+   * @param  {Function} predicate
+   * @return {Array}
+   */
+  static find(arr, predicate) {
+    let i;
+    let l;
+    if (Array.prototype.find) {
+      return Array.prototype.find.call(arr, predicate);
+    }
+    for (i = 0, l = arr.length; i < l; i += 1) {
+      const value = arr[i];
+      if (predicate(value, i)) {
+        return value;
+      }
+    }
+    return undefined;
+  }
+
+  /**
+   * Object::assign polyfill
+   *
+   * @param  {Object} obj
+   * @param  {Object} ...objs
+   * @return {Object}
+   */
+  static assign(obj, ...assigners) {
+    const result = obj;
+    let i;
+    let l;
+    if (Object.assign) {
+      return Object.assign(obj, ...assigners);
+    }
+    for (i = 0, l = assigners.length; i < l; i += 1) {
+      const assigner = assigners[i];
+      if (typeof assigner === 'object' && assigner !== null) {
+        const keys = Object.keys(assigner);
+        keys.forEach((key) => {
+          result[key] = assigner[key];
+        });
+      }
+    }
+    return obj;
+  }
+
+  /**
+   * Get short version/alias for a browser name
+   *
+   * @example
+   *   getBrowserAlias('Microsoft Edge') // edge
+   *
+   * @param  {string} browserName
+   * @return {string}
+   */
+  static getBrowserAlias(browserName) {
+    return BROWSER_ALIASES_MAP[browserName];
+  }
+
+  /**
+   * Get browser name for a short version/alias
+   *
+   * @example
+   *   getBrowserTypeByAlias('edge') // Microsoft Edge
+   *
+   * @param  {string} browserAlias
+   * @return {string}
+   */
+  static getBrowserTypeByAlias(browserAlias) {
+    return BROWSER_MAP[browserAlias] || '';
+  }
+}

test/acceptance/useragentstrings.yml

@@ -207,6 +207,21 @@
           type: "desktop"
         engine:
           name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36"
+      spec:
+        browser:
+          name: "Chrome"
+          version: "49.0.2623.112"
+        os:
+          name: "macOS"
+          version: "10.7.5"
+          versionName: "Lion"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "Blink"
     -
       ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_7) AppleWebKit/534.24 (KHTML, like Gecko) Chrome/11.0.696.57 Safari/534.24"
       spec:
@@ -216,6 +231,7 @@
         os:
           name: "macOS"
           version: "10.6.7"
+          versionName: "Snow Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -308,6 +324,64 @@
           type: "mobile"
         engine:
           name: "Blink"
+    - ua: "Mozilla/5.0 (Windows NT 10.0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.113 Safari/537.36 Roku/DVP-7.53 (147.53E04068A)"
+      spec:
+        browser:
+          name: "Chrome"
+          version: "60.0.3112.113"
+        os:
+          name: "Roku"
+          version: "7.53"
+        platform:
+          type: "tv"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Linux; Android 9; Nokia 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.127 Mobile Safari/537.36"
+      spec:
+        browser:
+          name: "Chrome"
+          version: "85.0.4183.127"
+        os:
+          name: "Android"
+          version: "9"
+          versionName: "Pie"
+        platform:
+          type: "mobile"
+          vendor: "Nokia"
+          model: "5.1"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Linux; Android 10; SM-G970F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3396.81 Mobile Safari/537.36"
+      spec:
+        browser:
+          name: "Chrome"
+          version: "75.0.3396.81"
+        os:
+          name: "Android"
+          version: "10"
+        platform:
+          type: "mobile"
+        engine:
+          name: "Blink"
+  Google Search:
+    -
+      ua: "Mozilla/5.0 (iPhone; CPU iPhone OS 12_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) GSA/83.0.268992909 Mobile/15E148 Safari/605.1"
+      spec:
+        browser:
+          name: "Google Search"
+          version: "83.0.268992909"
+        os:
+          name: "iOS"
+          version: "12.4"
+        platform:
+          type: "mobile"
+          vendor: "Apple"
+          model: "iPhone"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
   Amazon Silk:
     -
       ua: "Mozilla/5.0 (Linux; U; Android 4.0.3; en-us; KFTT Build/IML74K) AppleWebKit/535.19 (KHTML, like Gecko) Silk/3.4 Mobile Safari/535.19 Silk-Accelerated=true"
@@ -366,6 +440,7 @@
         os:
           name: "macOS"
           version: "10.6.3"
+          versionName: "Snow Leopard"
         platform:
           type: "tablet"
           vendor: "Amazon"
@@ -527,6 +602,7 @@
         os:
           name: "macOS"
           version: "10.6.7"
+          versionName: "Snow Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -643,6 +719,21 @@
         engine:
           name: "WebKit"
           version: "601.1.46"
+  Opera Touch:
+    -
+      ua: "Mozilla/5.0 (Linux; Android 7.0; SM-A520F Build/NRD90M; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/65.0.3325.109 Mobile Safari/537.36 OPT/1.0.9"
+      spec:
+        browser:
+          name: "Opera Touch"
+          version: "1.0.9"
+        os:
+          name: "Android"
+          version: "7.0"
+          versionName: 'Nougat'
+        platform:
+          type: "mobile"
+        engine:
+          name: "Blink"
   Yandex Browser:
     -
       ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.118 YaBrowser/15.4.2272.3420 (beta) Yowser/2.0 Safari/537.36"
@@ -653,6 +744,7 @@
         os:
           name: "macOS"
           version: "10.10.3"
+          versionName: "Yosemite"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -673,6 +765,22 @@
           vendor: "Nexus"
         engine:
           name: "Blink"
+    -
+      ua: "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.0 YaBrowser/19.3.3.157.10 Mobile/15E148 Safari/605.1"
+      spec:
+        browser:
+          name: "Yandex Browser"
+          version: "19.3.3.157.10"
+        os:
+          name: "iOS"
+          version: "12.2"
+        platform:
+          type: "mobile"
+          vendor: "Apple"
+          model: "iPhone"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
   Safari:
     -
       ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/537.13+ (KHTML, like Gecko) Version/5.1.7 Safari/534.57.2"
@@ -683,6 +791,7 @@
         os:
           name: "macOS"
           version: "10.6.8"
+          versionName: "Snow Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -698,6 +807,7 @@
         os:
           name: "macOS"
           version: "10.6.7"
+          versionName: "Snow Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -756,12 +866,29 @@
         os:
           name: "macOS"
           version: "10.6.1"
+          versionName: "Snow Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
         engine:
           name: "WebKit"
           version: "531.21.10"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_9_3) AppleWebKit/537.75.14 (KHTML, like Gecko) Version/7.0.3 Safari/7046A194A"
+      spec:
+        browser:
+          name: "Safari"
+          version: "7.0.3"
+        os:
+          name: "macOS"
+          version: "10.9.3"
+          versionName: "Mavericks"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "WebKit"
+          version: "537.75.14"
     -
       ua: "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_5_7; de-de) AppleWebKit/525.28.3 (KHTML, like Gecko) Version/3.2.3 Safari/525.28.3"
       spec:
@@ -771,6 +898,7 @@
         os:
           name: "macOS"
           version: "10.5.7"
+          versionName: "Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -840,6 +968,22 @@
         engine:
           name: "WebKit"
           version: "532.9"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13) AppleWebKit/604.1.31 (KHTML, like Gecko) Version/11.0 Safari/604.1.31"
+      spec:
+        browser:
+          name: "Safari"
+          version: "11.0"
+        os:
+          name: "macOS"
+          version: "10.13"
+          versionName: "High Sierra"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "WebKit"
+          version: "604.1.31"
     -
       ua: "Mozilla/5.0 (Macintosh; U; PPC Mac OS X 10_5_2; en-gb) AppleWebKit/526+ (KHTML, like Gecko) Version/3.1 iPhone"
       spec:
@@ -849,6 +993,7 @@
         os:
           name: "macOS"
           version: "10.5.2"
+          versionName: "Leopard"
         platform:
           type: "mobile"
           vendor: "Apple"
@@ -1275,6 +1420,7 @@
           version: "8.0"
         platform:
           type: "mobile"
+          vendor: "Nokia"
         engine:
           name: "Trident"
           version: "6.0"
@@ -1289,6 +1435,7 @@
           version: "8.0"
         platform:
           type: "mobile"
+          vendor: "Nokia"
         engine:
           name: "Trident"
           version: "6.0"
@@ -1317,6 +1464,7 @@
           version: "7.0"
         platform:
           type: "mobile"
+          vendor: "Nokia"
         engine:
           name: "Trident"
           version: "3.1"
@@ -1334,6 +1482,21 @@
         engine:
           name: "Trident"
           version: "7.0"
+    -
+      ua: "Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; Touch; .NET4.0C; .NET4.0E; .NET CLR 2.0.50727; .NET CLR 3.0.30729; .NET CLR 3.5.30729; Tablet PC 2.0; Zoom 3.6.0; InfoPath.3; rv:11.0) like Gecko"
+      spec:
+        browser:
+          name: "Internet Explorer"
+          version: "11.0"
+        os:
+          name: "Windows"
+          version: "NT 10.0"
+          versionName: "10"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Trident"
+          version: "7.0"
   Microsoft Edge:
     -
       ua: 'Mozilla/5.0 (Linux; Android 8.0; Pixel XL Build/OPP3.170518.006) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.0 Mobile Safari/537.36 EdgA/41.1.35.1'
@@ -1395,6 +1558,34 @@
         engine:
           name: "EdgeHTML"
           version: "12.0"
+    -
+      ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/74.0.3729.48 Safari/537.36 Edg/74.1.96.24"
+      spec:
+        browser:
+          name: "Microsoft Edge"
+          version: "74.1.96.24"
+        os:
+          name: "Windows"
+          version: "NT 10.0"
+          versionName: "10"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/75.0.3739.0 Safari/537.36 Edg/75.0.109.0"
+      spec:
+        browser:
+          name: "Microsoft Edge"
+          version: "75.0.109.0"
+        os:
+          name: "Windows"
+          version: "NT 10.0"
+          versionName: "10"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Blink"
   Firefox:
     -
       ua: "Mozilla/5.0 (Mobile; rv:26.0) Gecko/26.0 Firefox/26.0"
@@ -1484,6 +1675,7 @@
         os:
           name: "macOS"
           version: "10.8"
+          versionName: "Mountain Lion"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -1596,6 +1788,7 @@
         os:
           name: "macOS"
           version: "10.6"
+          versionName: "Snow Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -1661,6 +1854,53 @@
         engine:
           name: "WebKit"
           version: "601.1.46"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.14; rv:68.0) Gecko/20100101 Firefox/68.0"
+      spec:
+        browser:
+          name: "Firefox"
+          version: "68.0"
+        os:
+          name: "macOS"
+          version: "10.14"
+          versionName: "Mojave"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "Gecko"
+          version: "20100101"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/21.0 Version/13.0.3 Safari/605.1.15"
+      spec:
+        browser:
+          name: "Firefox"
+          version: "21.0"
+        os:
+          name: "iOS"
+          version: "13.0.3"
+        platform:
+          type: "tablet"
+          vendor: "Apple"
+          model: "iPad"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15) AppleWebKit/605.1.15 (KHTML, like Gecko) FxiOS/24.1 Safari/605.1.15"
+      spec:
+        browser:
+          name: "Firefox"
+          version: "24.1"
+        os:
+          name: "iOS"
+        platform:
+          type: "tablet"
+          vendor: "Apple"
+          model: "iPad"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
   SeaMonkey:
     -
       ua: "Mozilla/5.0 (Windows NT 5.2; rv:10.0.1) Gecko/20100101 Firefox/10.0.1 SeaMonkey/2.7.1"
@@ -1686,6 +1926,7 @@
         os:
           name: "macOS"
           version: "10.5"
+          versionName: "Leopard"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -2014,6 +2255,21 @@
         engine:
           name: "WebKit"
           version: "533.1"
+    -
+      ua: "Mozilla/5.0 (Linux; U; Android 2.2; en-us; GT-I5800 Build/FROYO) AppleWebKit/533.1 (KHTML, like Gecko) Version/4.0 Mobile Safari/533.1"
+      spec:
+        browser:
+          name: "Android Browser"
+          version: "4.0"
+        os:
+          name: "Android"
+          version: "2.2"
+          versionName: "Froyo"
+        platform:
+          type: "mobile"
+        engine:
+          name: "WebKit"
+          version: "533.1"
     -
       ua: "Mozilla/5.0 (Linux; U; Android 1.6; ar-us; SonyEricssonX10i Build/R2BA026) AppleWebKit/528.5+ (KHTML, like Gecko) Version/3.1.2 Mobile Safari/525.20.1"
       spec:
@@ -2196,6 +2452,7 @@
         os:
           name: "macOS"
           version: "10.11.1"
+          versionName: "El Capitan"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -2225,6 +2482,20 @@
         os: {}
         platform: {}
         engine: {}
+    -
+      ua: "Generic/2.15 (Macintosh; Intel Mac OS X 10_6_8)"
+      spec:
+        browser:
+          name: "Generic"
+          version: "2.15"
+        os:
+          name: "macOS"
+          version: "10.6.8"
+          versionName: "Snow Leopard"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine: {}
   Googlebot:
     -
       ua: "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"
@@ -2312,6 +2583,22 @@
         engine:
           name: "WebKit"
           version: "537.51.1"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Chrome/39.0.2171.95 Safari/537.36 MicroMessenger/6.5.2.501 NetType/WIFI WindowsWechat"
+      spec:
+        browser:
+          name: "WeChat"
+          version: "6.5.2.501"
+        os:
+          name: "macOS"
+          version: "10.15.1"
+          versionName: "Catalina"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
   UC Browser:
     -
       ua: "Mozilla/5.0 (iPad; U; CPU OS 9 like Mac OS X; en-us; iPad4,4) AppleWebKit/534.46 (KHTML, like Gecko) UCBrowser/2.4.0.367 U3/1 Safari/7543.48.3"
@@ -2545,6 +2832,7 @@
         os:
           name: "macOS"
           version: "10.12.6"
+          versionName: "Sierra"
         platform:
           type: "desktop"
           vendor: "Apple"
@@ -2595,3 +2883,235 @@
           type: "desktop"
         engine:
           name: "Blink"
+  PlayStation 4:
+    -
+      ua: "Mozilla/5.0 (PlayStation 4 6.20) AppleWebKit/605.1.15 (KHTML, like Gecko) "
+      spec:
+        browser:
+          name: "PlayStation 4"
+        os:
+          name: "PlayStation 4"
+          version: "6.20"
+        platform:
+          type: "tv"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
+  Roku:
+    -
+      ua: "Roku/DVP-9.0 (047.00E09044A)"
+      spec:
+        browser:
+          name: "Roku"
+          version: "DVP-9.0"
+        os:
+          name: "Roku"
+          version: "9.0"
+        platform:
+          type: "tv"
+        engine: {}
+  QQ Browser:
+    -
+      ua: "Mozilla/5.0 (Linux; U; Android 4.4.2; zh-cn; GT-I9500 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko)Version/4.0 MQQBrowser/5.0 QQ-URL-Manager Mobile Safari/537.36"
+      spec:
+        browser:
+          name: "QQ Browser"
+          version: "5.0"
+        os:
+          name: "Android"
+          version: "4.4.2"
+          versionName: "KitKat"
+        platform:
+          type: "mobile"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (iPhone 84; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Version/10.0 MQQBrowser/7.8.0 Mobile/14G60 Safari/8536.25 MttCustomUA/2 QBWebViewType/1 WKType/1"
+      spec:
+        browser:
+          name: "QQ Browser"
+          version: "7.8.0"
+        os:
+          name: "iOS"
+          version: "10.3.3"
+        platform:
+          model: "iPhone"
+          type: "mobile"
+          vendor: "Apple"
+        engine:
+          name: "WebKit"
+          version: "603.3.8"
+    -
+      ua: "Mozilla/5.0 (Linux; U; Android 9; zh-cn; DUK-AL20 Build/HUAWEIDUK-AL20) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/66.0.3359.126 MQQBrowser/9.6 Mobile Safari/537.36"
+      spec:
+        browser:
+          name: "QQ Browser"
+          version: "9.6"
+        os:
+          name: "Android"
+          version: "9"
+          versionName: "Pie"
+        platform:
+          type: "mobile"
+          vendor: "Huawei"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/53.0.2785.104 Safari/537.36 Core/1.53.2141.400 QQBrowser/9.5.10219.400"
+      spec:
+        browser:
+          name: "QQ Browser"
+          version: "9.5.10219.400"
+        os:
+          name: "Windows"
+          version: "NT 6.1"
+          versionName: "7"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/43.0.2357.134 Safari/537.36 QQBrowser/3.8.3858.400"
+      spec:
+        browser:
+          name: "QQ Browser"
+          version: "3.8.3858.400"
+        os:
+          name: "macOS"
+          version: "10.10.5"
+          versionName: "Yosemite"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "Blink"
+  QQ Browser Lite:
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.1.3 Safari/605.1.15 QQBrowserLite/1.2.5"
+      spec:
+        browser:
+          name: "QQ Browser Lite"
+          version: "1.2.5"
+        os:
+          name: "macOS"
+          version: "10.13.6"
+          versionName: "High Sierra"
+        platform:
+          type: "desktop"
+          vendor: "Apple"
+        engine:
+          name: "WebKit"
+          version: "605.1.15"
+  Electron:
+    -
+      ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) my-app/1.0.0 Chrome/78.0.3904.113 Electron/7.1.2 Safari/537.36"
+      spec:
+        browser:
+          name: "Electron"
+          version: "7.1.2"
+        os:
+          name: "Windows"
+          version: "NT 10.0"
+          versionName: "10"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.146 Electron/6.1.5 Safari/537.36"
+      spec:
+        browser:
+          name: "Electron"
+          version: "6.1.5"
+        os:
+          name: "Windows"
+          version: "NT 10.0"
+          versionName: "10"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.113 Electron/7.1.2 Safari/537.36"
+      spec:
+        browser:
+          name: "Electron"
+          version: "7.1.2"
+        os:
+          name: "macOS"
+          version: "10.15.1"
+          versionName: "Catalina"
+        platform:
+          type: "desktop"
+          vendor: 'Apple'
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/78.0.3904.113 Electron/7.1.2 Safari/537.36"
+      spec:
+        browser:
+          name: "Electron"
+          version: "7.1.2"
+        os:
+          name: "Linux"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Blink"
+  Miui:
+    -
+      ua: "Mozilla/5.0 (Linux; U; Android 9; fr-fr; Redmi Note 8 Pro Build/PPR1.180610.011) AppleWebKit/537.36 (KHTML like Gecko) Version/4.0 Chrome/71.0.3578.141 Mobile Safari/537.36 XiaoMi/MiuiBrowser/11.9.3-"
+      spec:
+        browser:
+          name: "Miui"
+          version: "11.9.3"
+        os:
+          name: "Android"
+          version: "9"
+          versionName: "Pie"
+        platform:
+          type: "mobile"
+        engine:
+          name: "Blink"
+    -
+      ua: "Mozilla/5.0 (Linux; U; Android 9; fr-fr; Redmi Note 8 Pro Build/PPR1.180610.011) AppleWebKit/537.36 (KHTML like Gecko) Version/4.0 Chrome/71.0.3578.141 Mobile Safari/537.36 XiaoMi/MiuiBrowser"
+      spec:
+        browser:
+          name: "Miui"
+        os:
+          name: "Android"
+          version: "9"
+          versionName: "Pie"
+        platform:
+          type: "mobile"
+        engine:
+          name: "Blink"
+  Pale Moon:
+    -
+      ua: "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:68.0) Gecko/20100101 Goanna/4.8 Firefox/68.0 PaleMoon/29.1.1"
+      spec:
+        browser:
+          name: "Pale Moon"
+          version: "29.1.1"
+        os:
+          name: "Windows"
+          version: "NT 10.0"
+          versionName: "10"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Gecko"
+          version: "20100101"
+    -
+      ua: "Mozilla/5.0 (X11; Linux i686; rv:45.9) Gecko/20100101 Goanna/3.2 Firefox/45.9 PaleMoon/27.2.0"
+      spec:
+        browser:
+          name: "Pale Moon"
+          version: "27.2.0"
+        os:
+          name: "Linux"
+        platform:
+          type: "desktop"
+        engine:
+          name: "Gecko"
+          version: "20100101"

test/unit/constants.js

@@ -0,0 +1,15 @@
+import test from 'ava';
+import { BROWSER_ALIASES_MAP } from '../../src/constants';
+
+test('check duplicate aliases', (t) => {
+  const aliasesList = Object.keys(BROWSER_ALIASES_MAP).map(value => (BROWSER_ALIASES_MAP[value]));
+  let foundOnce, foundTwice;
+
+  const duplicates = aliasesList.filter(item => {
+    foundOnce = aliasesList.indexOf(item);
+    foundTwice = aliasesList.indexOf(item, foundOnce + 1);
+    return +foundTwice !== -1;
+  });
+
+  t.deepEqual(duplicates, []);
+});

test/unit/parser.js

@@ -1,10 +1,17 @@
 import test from 'ava';
 import sinon from 'sinon';
 import Parser from '../../src/parser';
+import Bowser from '../../src/bowser';
 
 const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36 OPR/43.0.2442.1165';
 const parser = new Parser(UA, true);
 
+const EDGE_UA = 'Mozilla/5.0 (Linux; Android 8.0; Pixel XL Build/OPP3.170518.006) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.0 Mobile Safari/537.36 EdgA/41.1.35.1';
+const edgeParser = new Parser(EDGE_UA, true);
+
+const FOCUS_UA = 'Mozilla/5.0 (Linux; Android 7.1.1) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Focus/1.2.1 Chrome/59.0.3071.125';
+const focusParser = new Parser(FOCUS_UA, true);
+
 test('constructor', (t) => {
   t.truthy(parser instanceof Parser);
 });
@@ -145,12 +152,49 @@ test('Parser.satisfies for versionless UA strings', (t) => {
   }), void 0);
 });
 
+test('Parser.satisfies should consider aliases while handling browsers', (t) => {
+  t.is(edgeParser.satisfies({ 'Microsoft Edge': '=41.1.35.1' }), true);
+  t.is(edgeParser.satisfies({ 'microsoft edge': '=41.1.35.1' }), true);
+  t.is(edgeParser.satisfies({ 'edge': '=41.1.35.1' }), true);
+  t.is(edgeParser.satisfies({ 'Edge': '=41.1.35.1' }), true);
+});
+
 test('Parser.is should pass', (t) => {
   t.is(parser.is('opera'), true);
   t.is(parser.is('desktop'), true);
   t.is(parser.is('macos'), true);
 });
 
+test('Parser.is should pass when not including aliases', (t) => {
+  t.is(edgeParser.is('Microsoft Edge', false), true);
+  t.is(edgeParser.is('microsoft edge', false), true);
+  t.is(edgeParser.is('mIcrosoft eDge', false), true);
+  t.is(edgeParser.is('edge', false), false);
+  t.is(edgeParser.is('Edge', false), false);
+  t.is(edgeParser.is('desktop', false), false);
+  t.is(edgeParser.is('macos', false), false);
+  t.is(edgeParser.is('mobile', false), true);
+  t.is(edgeParser.is('android', false), true);
+});
+
+test('Parser.is should pass when including aliases', (t) => {
+  t.is(edgeParser.is('Microsoft Edge', true), true);
+  t.is(edgeParser.is('microsoft edge', true), true);
+  t.is(edgeParser.is('mIcrosoft eDge', true), true);
+  t.is(edgeParser.is('edge', true), true);
+  t.is(edgeParser.is('Edge', true), true);
+  t.is(edgeParser.is('desktop', true), false);
+  t.is(edgeParser.is('macos', true), false);
+  t.is(edgeParser.is('mobile', true), true);
+  t.is(edgeParser.is('android', true), true);
+});
+
+test('Parser.is using constants should pass', (t) => {
+  t.is(parser.is(Bowser.BROWSER_MAP.opera), true);
+  t.is(parser.is(Bowser.PLATFORMS_MAP.desktop), true);
+  t.is(parser.is(Bowser.OS_MAP.MacOS), true);
+});
+
 test('Parser.some should pass', (t) => {
   t.is(parser.some(['opera', 'chrome', 'firefox']), true);
   t.is(parser.some(['macos', 'windows']), true);
@@ -158,3 +202,29 @@ test('Parser.some should pass', (t) => {
   t.is(parser.some([]), false);
   t.is(parser.some(), false);
 });
+
+test('Parser.isBrowser should pass when not loosely checking', (t) => {
+  t.is(edgeParser.isBrowser('Microsoft Edge', false), true);
+  t.is(edgeParser.isBrowser('microsoft edge', false), true);
+  t.is(edgeParser.isBrowser('mIcrosoft eDge', false), true);
+  t.is(edgeParser.isBrowser('edge', false), false);
+  t.is(edgeParser.isBrowser('Edge', false), false);
+});
+
+test('Parser.isBrowser should pass when loosely checking', (t) => {
+  t.is(edgeParser.isBrowser('Microsoft Edge', true), true);
+  t.is(edgeParser.isBrowser('microsoft edge', true), true);
+  t.is(edgeParser.isBrowser('mIcrosoft eDge', true), true);
+  t.is(edgeParser.isBrowser('edge', true), true);
+  t.is(edgeParser.isBrowser('Edge', true), true);
+});
+
+test('Parser.isBrowser should pass for non-aliased browsers', (t) => {
+  t.is(focusParser.isBrowser('Focus', true), true);
+  t.is(focusParser.isBrowser('Focus', false), true);
+});
+
+test('Parser.isEngine should pass', (t) => {
+  t.is(parser.isEngine('blink'), true);
+  t.is(parser.isEngine('webkit'), false);
+});

test/unit/utils.js

@@ -1,8 +1,18 @@
 import test from 'ava';
 import {
   getFirstMatch,
+  getSecondMatch,
+  matchAndReturnConst,
   getWindowsVersionName,
+  getMacOSVersionName,
+  getAndroidVersionName,
+  getVersionPrecision,
   compareVersions,
+  map,
+  find,
+  assign,
+  getBrowserAlias,
+  getBrowserTypeByAlias
 } from '../../src/utils';
 
 test('getFirstMatch', (t) => {
@@ -10,11 +20,40 @@ test('getFirstMatch', (t) => {
   t.is(matchedVersion, '11.11.11');
 });
 
+test('getSecondMatch', (t) => {
+  const matchedVersion = getSecondMatch(/version\/(\S+).*version\/(\S+)/i, 'Chrome Version/11.11.11 Chrome Version/22.22.22');
+  t.is(matchedVersion, '22.22.22');
+});
+
+test('matchAndReturnConst', (t) => {
+  const _const = matchAndReturnConst(/version/i, 'version', "_const");
+  t.is(_const, '_const');
+});
+
 test('getWindowsVersionName', (t) => {
   t.is(getWindowsVersionName('NT 5.0'), '2000');
   t.is(getWindowsVersionName('XXX'), void 0);
 });
 
+test('getMacOSVersionName', (t) => {
+  t.is(getMacOSVersionName('10.14.5'), 'Mojave');
+  t.is(getMacOSVersionName('10.15'), 'Catalina');
+  t.is(getMacOSVersionName('10.999999'), void 0);
+  t.is(getMacOSVersionName('XXX'), void 0);
+});
+
+test('getAndroidVersionName', (t) => {
+  t.is(getAndroidVersionName('1.0'), void 0);
+  t.is(getAndroidVersionName('8.0'), 'Oreo');
+  t.is(getAndroidVersionName('9'), 'Pie');
+  t.is(getAndroidVersionName('XXX'), void 0);
+});
+
+test('getVersionPrecision', (t) => {
+  const precision = getVersionPrecision("10.14.5");
+  t.is(precision, 3);
+});
+
 test('compareVersions', (t) => {
   const comparisionsTasks = [
     ['9.0', '10', -1],
@@ -50,3 +89,52 @@ test('compareVersions', (t) => {
     t.is(compareVersions(versionA, versionB, isLoose), result, `version ${versionA} should be ${matching} version ${versionB}`);
   });
 });
+
+test('map', (t) => {
+  const result = map([1,2], (value) => value+2);
+  t.is(result[0], 3);
+  t.is(result[1], 4);
+  const original = Array.prototype.map;
+  delete Array.prototype.map;
+  const polyfillResult = map([1,2], (value) => value+2);
+  Array.prototype.map = original;
+  t.is(polyfillResult[0], 3);
+  t.is(polyfillResult[1], 4);
+});
+
+test('find', (t) => {
+  const result = find([1,2], (value) => value==2);
+  t.is(result, 2);
+  const original = Array.prototype.find;
+  delete Array.prototype.find;
+  const polyfillResultFound = find([1,2], (value) => value==2);
+  const polyfillResultNotFound = find([1,2], (value) => value==3);
+  Array.prototype.find = original;
+  t.is(polyfillResultFound, 2);
+  t.is(polyfillResultNotFound, undefined);
+});
+
+test('assign', (t) => {
+  const result = assign({}, { a: 1 }, { b: 1 }, { b: 2, c: 3 });
+  t.is(result['a'], 1);
+  t.is(result['b'], 2);
+  t.is(result['c'], 3);
+  const original = Object.assign;
+  delete Object.assign;
+  const polyfillResult = assign({}, { a: 1 }, { b: 1 }, null, { b: 2, c: 3 });
+  Object.assign = original;
+  t.is(polyfillResult['a'], 1);
+  t.is(polyfillResult['b'], 2);
+  t.is(polyfillResult['c'], 3);
+});
+
+test('getBrowserAlias', (t) => {
+  t.is(getBrowserAlias('Microsoft Edge'), 'edge');
+  t.is(getBrowserAlias('Unexisting Browser'), void 0);
+});
+
+test('getBrowserTypeByAlias', (t) => {
+  t.is(getBrowserTypeByAlias('edge'), 'Microsoft Edge');
+  t.is(getBrowserTypeByAlias(void 0), '');
+});
+

webpack.config.js

@@ -1,6 +1,11 @@
 const path = require('path');
+// const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
+const CompressionPlugin = require('compression-webpack-plugin');
 
 module.exports = {
+  plugins: [
+    new CompressionPlugin(),
+  ],
   mode: 'production', // "production" | "development" | "none"
   // Chosen mode tells webpack to use its built-in optimizations accordingly.
   entry: {