chore: move the token to secrets

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

.babelrc

@@ -1,7 +1,8 @@
 {
-  "presets": [["env", {
-    "useBuiltIns": true,
-    "modules": "umd",
+  "presets": [["@babel/preset-env", {
+    "useBuiltIns": "entry",
+    "modules": "cjs",
+    "loose": true,
     "targets": {
       "ie": "8",
       "browsers": ">2%"
@@ -13,7 +14,7 @@
   "env": {
     "test": {
       "plugins": [ "istanbul" ],
-      "presets": [["env", { "targets": { "node": "current" } }]]
+      "presets": [["@babel/preset-env", { "targets": { "node": "current" } }]]
     }
   }
 }

.coveralls.yml

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

.editorconfig

@@ -3,6 +3,7 @@ root = true
 [*]
 end_of_line = lf
 insert_final_newline = true
+trim_trailing_whitespace = true
 
 [{*.js,*.md}]
 charset = utf-8

.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

@@ -0,0 +1,42 @@
+# Contributing
+
+We're always open to pull requests or code reviews. Everyone can become a permanent contributor. Just ping @lancedikson in the issues or on Twitter ❤️
+
+## Branches
+
+The project runs Git-flow, where the `master` branch is for development and `production` is for production.
+
+In a nutshell, if you are proposing a new feature that adds totally new functionality to `bowser`, it's better to branch from `master` and make a PR pointing back to `master` as well.
+
+If it's a small hot-fix, an improvement to the docs, or added support for a new browser/OS/platform/etc, then it's better to branch from `production` and make a PR pointing back to `production`.
+
+Following these simple rules will really help maintain the repo! Thanks ❤️
+
+## 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. 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
+
+If you'd like to contribute a change to `bowser`, modify the files in `src/`, and run the following (you'll need `node` + `npm` installed):
+
+``` sh
+$ npm install
+$ npm run build #build
+$ npm test #run tests
+$ npm run lint #check lint rules
+```

.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

.nycrc

@@ -1,4 +1,10 @@
 {
   "sourceMap": false,
-  "instrument": false
+  "instrument": false,
+  "include": [
+    "src/**/*.js"
+  ],
+  "exclude": [
+    "*.js"
+  ]
 }

.travis.yml

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

CHANGELOG.md

@@ -1,5 +1,105 @@
 # 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)
+- [FIX] Fix README
+
+### 2.0.0 (January 19, 2019)
+- [ADD] Support a non strict equality in `Parser.satisfies()` (#275)
+- [ADD] Add Android versions names (#276)
+- [ADD] Add a typings file (#277)
+- [ADD] Added support for Googlebot recognition (#278)
+- [FIX] Update building tools, avoid security issues
+
+### 2.0.0-beta.3 (September 15, 2018)
+- [FIX] Fix Chrome Mobile detection (#253)
+- [FIX] Use built bowser for CI (#252)
+- [FIX] Update babel-plugin-add-module-exports (#251)
+
 ### 2.0.0-beta.2 (September 9, 2018)
 - [FIX] Fix failing comparing version through `Parser.satisfies` (#243)
 - [FIX] Fix travis testing, include eslint into CI testing
@@ -77,7 +177,7 @@
 
 ### 1.5.0 (October 31, 2016)
 - [ADD] Throw an error when `minVersion` map has not a string as a version and fix readme (#165)
-- [FIX] Fix truly detection of Windows Phones (#167) 
+- [FIX] Fix truly detection of Windows Phones (#167)
 
 ### 1.4.6 (September 19, 2016)
 - [FIX] Fix mobile Opera's version detection on Android
@@ -115,4 +215,4 @@
 - [FEATURE] Add `bowser.check` method
 - [DOC] Changelog started
 - [DOC] Add API section to README
-- [FIX] Fix detection of browser type (A/C/X) for Chromium 
+- [FIX] Fix detection of browser type (A/C/X) for Chromium

CONTRIBUTING.md

@@ -1,7 +0,0 @@
-# Contributing
-
-The project runs Git-flow, where the `master` branch is the production one and the `develop` is the developing one.
-
-In a nutshell, if you're about to propose a new feature with adding new functionality to bowser, it's better to branch from `develop` and make a PR pointing to `develop` as well.
-If it's a small hotfix, fix a typo in the docs or you've added support for a new browser/OS/platform/etc, then it's better to branch from `master` and make a PR pointing to `master` as well.
-Following these simple rules will help to maintain the repo a lot! Thanks ❤️

README.md

@@ -1,35 +1,42 @@
 ## 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/)
+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/.
 
-_Please, note that this is an alpha version. Check out the [1.x](https://github.com/lancedikson/bowser/tree/v1.x) branch for a stable version._
+### ⚠️ Version 2.0 breaking changes ⚠️
 
-**Changes of the 2.0**
-The upcoming 2.0 version 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:
+First of all, require the library. This is a UMD Module, so it will work for AMD, TypeScript, ES6, and CommonJS module systems.
 
 ```javascript
-const bowser = require('bowser');
+const Bowser = require("bowser"); // CommonJS
+
+import * as Bowser from "bowser"; // TypeScript
+
+import Bowser from "bowser"; // ES6 (and TypeScript with --esModuleInterop enabled)
 ```
 
-By default, `require('bowser')` requires the *ES5 version of files*, which
-**do not** include any polyfills.
+By default, the exported version is the *ES5 transpiled version*, which **do not** include any polyfills.
 
-In case if you don't use your own `babel-polyfill` you may need to have pre-built bundle with all needed polyfills.
+In case you don't use your own `babel-polyfill` you may need to have pre-built bundle with all needed polyfills.
 So, for you it's suitable to require bowser like this: `require('bowser/bundled')`.
 As the result, you get a ES5 version of bowser with `babel-polyfill` bundled together.
 
@@ -37,10 +44,10 @@ You may need to use the source files, so they will be available in the package a
 
 ## Browser props detection
 
-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 make it with Bowser:
+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:
 
 ```javascript
-const browser = bowser.getParser(window.navigator.userAgent);
+const browser = Bowser.getParser(window.navigator.userAgent);
 
 console.log(`The current browser name is "${browser.getBrowserName()}"`);
 // The current browser name is "Internet Explorer"
@@ -49,20 +56,21 @@ console.log(`The current browser name is "${browser.getBrowserName()}"`);
 or
 
 ```javascript
-const impression = new Impression();
+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;
+// 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
 {
   browser: {
@@ -91,7 +99,7 @@ You could want to filter some particular browsers to provide any special support
 It could look like this:
 
 ```javascript
-const browser = bowser.getParser(window.navigator.userAgent);
+const browser = Bowser.getParser(window.navigator.userAgent);
 const isValidBrowser = browser.satisfies({
   // declare browsers per OS
   windows: {
@@ -103,20 +111,20 @@ const isValidBrowser = browser.satisfies({
 
   // per platform (mobile, desktop or tablet)
   mobile: {
-    safari: '>9',
+    safari: '>=9',
     'android browser': '>3.10'
   },
 
   // or in general
-  chrome: ">20.1.1432",
+  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)
 });
 ```
@@ -126,22 +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.
 
-# Contributing
-If you'd like to contribute a change to bowser, modify the files in `src/`, then run the following (you'll need node + npm installed):
+### Browser names for `.satisfies()`
 
-``` sh
-$ npm install
-$ npm test
-```
+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).
 
-### Adding 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.
-
-### Similar Projects
+## 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>
 
 
@@ -230,8 +143,8 @@ All the one-instance stuff is located in Parser class.</p></div>
 
     <h5>Example</h5>
     
-    <pre class="prettyprint"><code>const bowser = new Bowser(window.navigator.userAgent);
-bowser.getResult()</code></pre>
+    <pre class="prettyprint"><code>const parser = Bowser.getParser(window.navigator.userAgent);
+const result = parser.getResult();</code></pre>
 
 
 
@@ -332,7 +245,8 @@ bowser.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 @@ bowser.getResult()</code></pre>
 
 
 
+
+
 <h5>Throws:</h5>
 
         
@@ -401,6 +317,7 @@ bowser.getResult()</code></pre>
     
 
 
+
         
             
 
@@ -418,7 +335,7 @@ bowser.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#line42">line 42</a>
+        <a href="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line56">line 56</a>
     </li></ul></dd>
     
 
@@ -469,6 +386,11 @@ bowser.getResult()</code></pre>
 
 
 
+    <h5>Example</h5>
+    
+    <pre class="prettyprint"><code>const result = Bowser.parse(window.navigator.userAgent);</code></pre>
+
+
 
 
     <h5>Parameters:</h5>
@@ -527,6 +449,8 @@ bowser.getResult()</code></pre>
 
 
 
+
+
 <h5>Returns:</h5>
 
         
@@ -547,6 +471,7 @@ bowser.getResult()</code></pre>
     
 
 
+
         
     
 
@@ -567,12 +492,14 @@ bowser.getResult()</code></pre>
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 3.5.5</a> on Sun Sep 09 2018 15:08:13 GMT+0300 (EEST) 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#line438">line 438</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#line340">line 340</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#line447">line 447</a>
+        <a href="parser.js.html">parser.js</a>, <a href="parser.js.html#line491">line 491</a>
     </li></ul></dd>
     
 
@@ -2422,7 +2858,7 @@ Returns <code>undefined</code> when the browser is no described in the checkTree
 
 
 <div class="description">
-    <p>Check if any of the given values satifies this.is(anything)</p>
+    <p>Check if any of the given values satisfies this.is(anything)</p>
 </div>
 
 
@@ -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 Sun Sep 09 2018 15:08:13 GMT+0300 (EEST) 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,19 +62,24 @@ 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
    *
    * @example
-   * const bowser = new Bowser(window.navigator.userAgent);
-   * bowser.getResult()
+   * const parser = Bowser.getParser(window.navigator.userAgent);
+   * const result = parser.getResult();
    */
   static getParser(UA, skipParsing = false) {
     if (typeof UA !== 'string') {
@@ -81,10 +93,29 @@ class Bowser {
    *
    * @param UA
    * @return {ParsedResult}
+   *
+   * @example
+   * const result = Bowser.parse(window.navigator.userAgent);
    */
   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;
@@ -102,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 Sun Sep 09 2018 15:08:13 GMT+0300 (EEST) 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,40 +55,62 @@
     
 
 
+
     <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 the 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:</p>
-<pre class="prettyprint source lang-javascript"><code>const bowser = require('bowser');</code></pre><p>By default, <code>require('bowser')</code> requires the <em>ES5 version of files</em>, which
-<strong>do not</strong> include any polyfills.</p>
-<p>In case if you don't use your own <code>babel-polyfill</code> you may need to have pre-built bundle with all needed polyfills.
+<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
+
+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 make 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());
+
+// 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));
 
-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
 {
   browser: {
@@ -101,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: {
@@ -115,33 +146,56 @@ const isValidBrowser = browser.satisfies({
 
   // per platform (mobile, desktop or tablet)
   mobile: {
-    safari: '>9',
+    safari: '>=9',
     'android browser': '>3.10'
   },
 
   // or in general
-  chrome: &quot;>20.1.1432&quot;,
+  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
-$ npm test</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>
 
 
@@ -156,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 Sun Sep 09 2018 15:08:13 GMT+0300 (EEST) 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,8 +373,7 @@ class Parser {
    * @return {ParsedResult}
    */
   getResult() {
-    /* TODO: Make this function pure, return a new object instead of the reference */
-    return this.parsedResult;
+    return Utils.assign({}, this.parsedResult);
   }
 
   /**
@@ -373,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 = {};
@@ -401,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]);
@@ -411,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]);
 
@@ -423,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]);
@@ -433,12 +450,25 @@ 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) {
-    let expectedResult = 0;
+    let expectedResults = [0];
     let comparableVersion = version;
     let isLoose = false;
 
@@ -448,12 +478,19 @@ class Parser {
       return void 0;
     }
 
-    if (version[0] === '>') {
-      expectedResult = 1;
-      comparableVersion = version.substr(1);
-    } else if (version[0] === '&lt;') {
-      expectedResult = -1;
+    if (version[0] === '>' || version[0] === '&lt;') {
       comparableVersion = version.substr(1);
+      if (version[1] === '=') {
+        isLoose = true;
+        comparableVersion = version.substr(2);
+      } else {
+        expectedResults = [];
+      }
+      if (version[0] === '>') {
+        expectedResults.push(1);
+      } else {
+        expectedResults.push(-1);
+      }
     } else if (version[0] === '=') {
       comparableVersion = version.substr(1);
     } else if (version[0] === '~') {
@@ -461,7 +498,9 @@ class Parser {
       comparableVersion = version.substr(1);
     }
 
-    return compareVersions(currentBrowserVersion, comparableVersion, isLoose) === expectedResult;
+    return expectedResults.indexOf(
+      Utils.compareVersions(currentBrowserVersion, comparableVersion, isLoose),
+    ) > -1;
   }
 
   isOS(osName) {
@@ -472,18 +511,24 @@ 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);
   }
 
   /**
-   * Check if any of the given values satifies this.is(anything)
+   * Check if any of the given values satisfies this.is(anything)
    * @param {String[]} anythings
    * @returns {Boolean}
    */
@@ -507,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 Sun Sep 09 2018 15:08:13 GMT+0300 (EEST) 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,91 @@
     }
   }
 
+  /**
+   * 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
+   *    1.6 - Donut
+   *    2.0 - Eclair
+   *    2.1 - Eclair
+   *    2.2 - Froyo
+   *    2.x - Gingerbread
+   *    3.x - Honeycomb
+   *    4.0 - Ice Cream Sandwich
+   *    4.1 - Jelly Bean
+   *    4.4 - KitKat
+   *    5.x - Lollipop
+   *    6.x - Marshmallow
+   *    7.x - Nougat
+   *    8.x - Oreo
+   *    9.x - Pie
+   *
+   * @example
+   *   getAndroidVersionName("7.0") // 'Nougat'
+   *
+   * @param  {string} version
+   * @return {string} versionName
+   */
+  static getAndroidVersionName(version) {
+    const v = version.split('.').splice(0, 2).map(s => parseInt(s, 10) || 0);
+    v.push(0);
+    if (v[0] === 1 &amp;&amp; v[1] &lt; 5) return undefined;
+    if (v[0] === 1 &amp;&amp; v[1] &lt; 6) return 'Cupcake';
+    if (v[0] === 1 &amp;&amp; v[1] >= 6) return 'Donut';
+    if (v[0] === 2 &amp;&amp; v[1] &lt; 2) return 'Eclair';
+    if (v[0] === 2 &amp;&amp; v[1] === 2) return 'Froyo';
+    if (v[0] === 2 &amp;&amp; v[1] > 2) return 'Gingerbread';
+    if (v[0] === 3) return 'Honeycomb';
+    if (v[0] === 4 &amp;&amp; v[1] &lt; 1) return 'Ice Cream Sandwich';
+    if (v[0] === 4 &amp;&amp; v[1] &lt; 4) return 'Jelly Bean';
+    if (v[0] === 4 &amp;&amp; v[1] >= 4) return 'KitKat';
+    if (v[0] === 5) return 'Lollipop';
+    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;
+  }
+
   /**
    * Get version precisions count
    *
@@ -166,6 +254,8 @@
         return -1;
       }
     }
+
+    return undefined;
   }
 
   /**
@@ -186,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>
@@ -203,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 Sun Sep 09 2018 15:08:13 GMT+0300 (EEST) 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

@@ -0,0 +1,315 @@
+// Type definitions for Bowser v2
+// Project: https://github.com/lancedikson/bowser
+// Definitions by: Alexander P. Cerutti <https://github.com/alexandercerutti>,
+
+export default Bowser;
+export as namespace Bowser;
+
+declare namespace Bowser {
+  /**
+   * Creates a Parser instance
+   * @param {string} UA - User agent string
+   * @param {boolean} skipParsing
+   */
+
+  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}
+   */
+
+  function parse(UA: string): Parser.ParsedResult;
+
+  /**
+   * 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.0.0-beta.2",
   "description": "Lightweight browser detector",
   "keywords": [
     "browser",
@@ -21,40 +20,45 @@
     }
   ],
   "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": {
-    "ava": "^0.25.0",
-    "babel-cli": "^6.26.0",
-    "babel-core": "^6.26.3",
-    "babel-eslint": "^9.0.0",
-    "babel-loader": "^7.1.5",
-    "babel-plugin-add-module-exports": "^0.3.1",
-    "babel-plugin-istanbul": "^4.1.6",
-    "babel-polyfill": "^6.26.0",
-    "babel-preset-env": "^1.7.0",
-    "babel-register": "^6.26.0",
-    "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.13.0",
-    "jsdoc": "^3.5.5",
-    "nyc": "^12.0.2",
-    "sinon": "^6.1.5",
-    "testem": "^2.9.3",
-    "webpack": "^4.15.1",
-    "webpack-cli": "^3.0.8",
+    "@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": {
     "require": [
-      "babel-register"
-    ],
-    "babel": "inherit"
+      "@babel/register"
+    ]
   },
   "bugs": {
     "url": "https://github.com/lancedikson/bowser/issues"
@@ -64,12 +68,16 @@
   },
   "scripts": {
     "build": "webpack --config webpack.config.js",
-    "prepublish": "npm run build",
-    "lint": "eslint ./src",
+    "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: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,19 +18,24 @@ 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
    *
    * @example
-   * const bowser = new Bowser(window.navigator.userAgent);
-   * bowser.getResult()
+   * const parser = Bowser.getParser(window.navigator.userAgent);
+   * const result = parser.getResult();
    */
   static getParser(UA, skipParsing = false) {
     if (typeof UA !== 'string') {
@@ -38,10 +49,29 @@ class Bowser {
    *
    * @param UA
    * @return {ParsedResult}
+   *
+   * @example
+   * const result = Bowser.parse(window.navigator.userAgent);
    */
   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,14 +23,28 @@
  * 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;
 
 const browsersList = [
+  /* Googlebot */
+  {
+    test: [/googlebot/i],
+    describe(ua) {
+      const browser = {
+        name: 'Googlebot',
+      };
+      const version = Utils.getFirstMatch(/googlebot\/(\d+(\.\d+))/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
+
+      if (version) {
+        browser.version = version;
+      }
+
+      return browser;
+    },
+  },
+
   /* Opera < 13.0 */
   {
     test: [/opera/i],
@@ -38,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;
@@ -50,12 +64,12 @@ const browsersList = [
 
   /* Opera > 13.0 */
   {
-    test: [/opr|opios/i],
+    test: [/opr\/|opios/i],
     describe(ua) {
       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;
@@ -70,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;
@@ -85,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;
@@ -100,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;
@@ -115,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;
@@ -130,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;
@@ -145,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;
@@ -160,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;
@@ -175,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;
@@ -190,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;
@@ -205,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;
@@ -220,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;
@@ -235,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;
@@ -250,7 +294,37 @@ 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;
+      }
+
+      return browser;
+    },
+  },
+  {
+    test: [/micromessenger/i],
+    describe(ua) {
+      const browser = {
+        name: 'WeChat',
+      };
+      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;
@@ -265,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;
@@ -281,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;
@@ -296,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;
@@ -311,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;
@@ -327,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;
@@ -342,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;
@@ -357,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;
@@ -372,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;
@@ -387,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;
@@ -402,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;
@@ -417,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;
@@ -432,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;
@@ -447,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;
@@ -462,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;
@@ -477,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;
@@ -492,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;
@@ -513,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;
@@ -530,24 +682,7 @@ const browsersList = [
       const browser = {
         name: 'Safari',
       };
-      const version = getFirstMatch(commonVersionIdentifier, ua);
-
-      if (version) {
-        browser.version = version;
-      }
-
-      return browser;
-    },
-  },
-
-  /* Googlebot */
-  {
-    test: [/googlebot/i],
-    describe(ua) {
-      const browser = {
-        name: 'Googlebot',
-      };
-      const version = getFirstMatch(/googlebot\/(\d+(\.\d+))/i, ua) || getFirstMatch(commonVersionIdentifier, ua);
+      const version = Utils.getFirstMatch(commonVersionIdentifier, ua);
 
       if (version) {
         browser.version = version;
@@ -561,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,16 +1,26 @@
-import {
-  getFirstMatch,
-  getWindowsVersionName,
-} 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,
       };
     },
@@ -18,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;
     },
   },
 
@@ -47,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,
       };
     },
@@ -64,11 +95,16 @@ export default [
       return notLikeAndroid && butAndroid;
     },
     describe(ua) {
-      const version = getFirstMatch(/android[\s/-](\d+(\.\d+)*)/i, ua);
-      return {
-        name: 'Android',
+      const version = Utils.getFirstMatch(/android[\s/-](\d+(\.\d+)*)/i, ua);
+      const versionName = Utils.getAndroidVersionName(version);
+      const os = {
+        name: OS_MAP.Android,
         version,
       };
+      if (versionName) {
+        os.versionName = versionName;
+      }
+      return os;
     },
   },
 
@@ -76,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) {
@@ -92,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,
       };
     },
@@ -107,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,
       };
     },
@@ -120,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,
       };
     },
@@ -134,7 +170,29 @@ export default [
     test: [/linux/i],
     describe() {
       return {
-        name: 'Linux',
+        name: OS_MAP.Linux,
+      };
+    },
+  },
+
+  /* Chrome OS */
+  {
+    test: [/CrOS/],
+    describe() {
+      return {
+        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
@@ -12,12 +7,39 @@ const TYPES_LABELS = {
  */
 
 export default [
+  /* Googlebot */
+  {
+    test: [/googlebot/i],
+    describe() {
+      return {
+        type: PLATFORMS_MAP.bot,
+        vendor: 'Google',
+      };
+    },
+  },
+
+  /* Huawei */
+  {
+    test: [/huawei/i],
+    describe(ua) {
+      const model = Utils.getFirstMatch(/(can-l01)/i, ua) && 'Nova';
+      const platform = {
+        type: PLATFORMS_MAP.mobile,
+        vendor: 'Huawei',
+      };
+      if (model) {
+        platform.model = model;
+      }
+      return platform;
+    },
+  },
+
   /* Nexus Tablet */
   {
     test: [/nexus\s*(?:7|8|9|10).*/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
         vendor: 'Nexus',
       };
     },
@@ -28,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',
       };
@@ -40,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',
       };
@@ -52,7 +86,7 @@ export default [
     test: [/silk/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
         vendor: 'Amazon',
       };
     },
@@ -60,10 +94,10 @@ export default [
 
   /* Tablet */
   {
-    test: [/tablet/i],
+    test: [/tablet(?! pc)/i],
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
       };
     },
   },
@@ -76,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,
       };
@@ -90,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,
       };
     },
   },
@@ -113,7 +163,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'BlackBerry',
       };
     },
@@ -126,7 +176,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
       };
     },
   },
@@ -138,7 +188,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
         vendor: 'Microsoft',
       };
     },
@@ -152,7 +202,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.tablet,
+        type: PLATFORMS_MAP.tablet,
       };
     },
   },
@@ -164,7 +214,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.mobile,
+        type: PLATFORMS_MAP.mobile,
       };
     },
   },
@@ -176,7 +226,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.desktop,
+        type: PLATFORMS_MAP.desktop,
         vendor: 'Apple',
       };
     },
@@ -189,7 +239,7 @@ export default [
     },
     describe() {
       return {
-        type: TYPES_LABELS.desktop,
+        type: PLATFORMS_MAP.desktop,
       };
     },
   },
@@ -201,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));
       }
 
@@ -272,6 +272,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 {{}}
@@ -279,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));
       }
 
@@ -300,6 +313,7 @@ class Parser {
 
   /**
    * Parse full information about the browser
+   * @returns {Parser}
    */
   parse() {
     this.parseBrowser();
@@ -315,8 +329,7 @@ class Parser {
    * @return {ParsedResult}
    */
   getResult() {
-    /* TODO: Make this function pure, return a new object instead of the reference */
-    return this.parsedResult;
+    return Utils.assign({}, this.parsedResult);
   }
 
   /**
@@ -330,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 = {};
@@ -358,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]);
@@ -368,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]);
 
@@ -380,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]);
@@ -390,12 +406,25 @@ 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) {
-    let expectedResult = 0;
+    let expectedResults = [0];
     let comparableVersion = version;
     let isLoose = false;
 
@@ -405,12 +434,19 @@ class Parser {
       return void 0;
     }
 
-    if (version[0] === '>') {
-      expectedResult = 1;
-      comparableVersion = version.substr(1);
-    } else if (version[0] === '<') {
-      expectedResult = -1;
+    if (version[0] === '>' || version[0] === '<') {
       comparableVersion = version.substr(1);
+      if (version[1] === '=') {
+        isLoose = true;
+        comparableVersion = version.substr(2);
+      } else {
+        expectedResults = [];
+      }
+      if (version[0] === '>') {
+        expectedResults.push(1);
+      } else {
+        expectedResults.push(-1);
+      }
     } else if (version[0] === '=') {
       comparableVersion = version.substr(1);
     } else if (version[0] === '~') {
@@ -418,29 +454,52 @@ class Parser {
       comparableVersion = version.substr(1);
     }
 
-    return compareVersions(currentBrowserVersion, comparableVersion, isLoose) === expectedResult;
+    return expectedResults.indexOf(
+      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();
+  }
+
   /**
    * 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);
   }
 
   /**
-   * Check if any of the given values satifies this.is(anything)
+   * Check if any of the given values satisfies this.is(anything)
    * @param {String[]} anythings
    * @returns {Boolean}
    */

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,91 @@ 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
+   *    1.6 - Donut
+   *    2.0 - Eclair
+   *    2.1 - Eclair
+   *    2.2 - Froyo
+   *    2.x - Gingerbread
+   *    3.x - Honeycomb
+   *    4.0 - Ice Cream Sandwich
+   *    4.1 - Jelly Bean
+   *    4.4 - KitKat
+   *    5.x - Lollipop
+   *    6.x - Marshmallow
+   *    7.x - Nougat
+   *    8.x - Oreo
+   *    9.x - Pie
+   *
+   * @example
+   *   getAndroidVersionName("7.0") // 'Nougat'
+   *
+   * @param  {string} version
+   * @return {string} versionName
+   */
+  static getAndroidVersionName(version) {
+    const v = version.split('.').splice(0, 2).map(s => parseInt(s, 10) || 0);
+    v.push(0);
+    if (v[0] === 1 && v[1] < 5) return undefined;
+    if (v[0] === 1 && v[1] < 6) return 'Cupcake';
+    if (v[0] === 1 && v[1] >= 6) return 'Donut';
+    if (v[0] === 2 && v[1] < 2) return 'Eclair';
+    if (v[0] === 2 && v[1] === 2) return 'Froyo';
+    if (v[0] === 2 && v[1] > 2) return 'Gingerbread';
+    if (v[0] === 3) return 'Honeycomb';
+    if (v[0] === 4 && v[1] < 1) return 'Ice Cream Sandwich';
+    if (v[0] === 4 && v[1] < 4) return 'Jelly Bean';
+    if (v[0] === 4 && v[1] >= 4) return 'KitKat';
+    if (v[0] === 5) return 'Lollipop';
+    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;
+  }
+
   /**
    * Get version precisions count
    *
@@ -123,6 +210,8 @@ class Utils {
         return -1;
       }
     }
+
+    return undefined;
   }
 
   /**
@@ -143,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/test-list-of-ua.js

@@ -2,16 +2,19 @@ import test from 'ava';
 import yaml from 'yamljs';
 import path from 'path';
 import Bowser from '../../src/bowser';
+import BowserBuild from '../../es5';
 
 const listOfUA = yaml.load(path.join(__dirname, 'useragentstrings.yml'));
 
 const browserNames = Object.keys(listOfUA);
 
 browserNames.forEach((browserName) => {
-  listOfUA[browserName].forEach((browser) => {
-    test('Check all the test browsers', (t) => {
+  listOfUA[browserName].forEach((browser, index) => {
+    test(`Test ${browserName} ${index}`, (t) => {
       const parsed = Bowser.parse(browser.ua);
+      const parsedBuild = BowserBuild.parse(browser.ua);
       t.deepEqual(parsed, browser.spec, `${browser.ua}`);
+      t.deepEqual(parsedBuild, browser.spec, `${browser.ua}`);
       t.is(parsed.browser.name, browserName, `${browser.ua}`);
     });
   });

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);
 });
@@ -53,6 +60,21 @@ test('Parser.getOSVersion returns a correct result', (t) => {
   t.is(parser.getOSVersion(), '10.12.4');
 });
 
+test('Parser.parseEngine is being called when getEngine() called', (t) => {
+  const spy = sinon.spy(parser, 'parseEngine');
+  parser.getEngine();
+  t.truthy(spy.called);
+  parser.parseEngine.restore();
+});
+
+test('Parser.getEngineName gives a name of the engine', (t) => {
+  t.is(parser.getEngineName(), 'Blink');
+});
+
+test('Parser.getEngineName gives a lower-cased name of the engine', (t) => {
+  t.is(parser.getEngineName(true), 'blink');
+});
+
 test('Skip parsing shouldn\'t parse', (t) => {
   t.deepEqual((new Parser(UA, true)).getResult(), {});
 });
@@ -63,6 +85,14 @@ test('Parser.satisfies should make simple comparisons', (t) => {
   t.is(parser.satisfies({ opera: '<44' }), true);
   t.is(parser.satisfies({ opera: '=43.0.2442.1165' }), true);
   t.is(parser.satisfies({ opera: '~43.0' }), true);
+  t.is(parser.satisfies({ opera: '>=43' }), true);
+  t.is(parser.satisfies({ opera: '<=43' }), true);
+  t.is(parser.satisfies({ opera: '>=43.0' }), true);
+  t.is(parser.satisfies({ opera: '>=43.0.2442.1165' }), true);
+  t.is(parser.satisfies({ opera: '<=43.0.2442.1165' }), true);
+  t.is(parser.satisfies({ opera: '>=43.0.2443' }), false);
+  t.is(parser.satisfies({ opera: '<=43.0.2443' }), true);
+  t.is(parser.satisfies({ opera: '>=43.0.2441' }), true);
   t.is(parser.satisfies({ opera: '~43' }), true);
 });
 
@@ -122,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);
@@ -135,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,10 +1,15 @@
 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: {
-    bundled: ['babel-polyfill', './src/bowser.js'],
+    bundled: ['@babel/polyfill', './src/bowser.js'],
     es5: './src/bowser.js',
   }, // string | object | array
   // defaults to ./src