mirror of
https://github.com/lancedikson/bowser
synced 2025-06-13 13:03:52 +00:00
Compare commits
No commits in common. "master" and "1.9.1" have entirely different histories.
20
.babelrc
20
.babelrc
@ -1,20 +0,0 @@
|
|||||||
{
|
|
||||||
"presets": [["@babel/preset-env", {
|
|
||||||
"useBuiltIns": "entry",
|
|
||||||
"modules": "cjs",
|
|
||||||
"loose": true,
|
|
||||||
"targets": {
|
|
||||||
"ie": "8",
|
|
||||||
"browsers": ">2%"
|
|
||||||
}
|
|
||||||
}]],
|
|
||||||
"plugins": [
|
|
||||||
"add-module-exports"
|
|
||||||
],
|
|
||||||
"env": {
|
|
||||||
"test": {
|
|
||||||
"plugins": [ "istanbul" ],
|
|
||||||
"presets": [["@babel/preset-env", { "targets": { "node": "current" } }]]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1 +0,0 @@
|
|||||||
|
|
||||||
@ -3,7 +3,6 @@ root = true
|
|||||||
[*]
|
[*]
|
||||||
end_of_line = lf
|
end_of_line = lf
|
||||||
insert_final_newline = true
|
insert_final_newline = true
|
||||||
trim_trailing_whitespace = true
|
|
||||||
|
|
||||||
[{*.js,*.md}]
|
[{*.js,*.md}]
|
||||||
charset = utf-8
|
charset = utf-8
|
||||||
|
|||||||
@ -1,14 +0,0 @@
|
|||||||
parser: babel-eslint
|
|
||||||
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
|
|
||||||
42
.github/CONTRIBUTING.md
vendored
42
.github/CONTRIBUTING.md
vendored
@ -1,42 +0,0 @@
|
|||||||
# 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
|
|
||||||
```
|
|
||||||
2
.github/FUNDING.yml
vendored
2
.github/FUNDING.yml
vendored
@ -1,2 +0,0 @@
|
|||||||
github: lancedikson
|
|
||||||
open_collective: lancedikson
|
|
||||||
19
.github/release-drafter.yml
vendored
19
.github/release-drafter.yml
vendored
@ -1,19 +0,0 @@
|
|||||||
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
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
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 }}
|
|
||||||
38
.github/workflows/merge-to-master.yml
vendored
38
.github/workflows/merge-to-master.yml
vendored
@ -1,38 +0,0 @@
|
|||||||
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 }}
|
|
||||||
29
.github/workflows/publish.yml
vendored
29
.github/workflows/publish.yml
vendored
@ -1,29 +0,0 @@
|
|||||||
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 }}
|
|
||||||
44
.github/workflows/pull-request.yml
vendored
44
.github/workflows/pull-request.yml
vendored
@ -1,44 +0,0 @@
|
|||||||
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
|
|
||||||
7
.gitignore
vendored
7
.gitignore
vendored
@ -1,7 +1,4 @@
|
|||||||
node_modules/
|
node_modules/
|
||||||
.idea/
|
.idea/
|
||||||
.nyc_output
|
/bowser.js
|
||||||
coverage
|
/bowser.min.js
|
||||||
dist
|
|
||||||
bundled.js*
|
|
||||||
es5.js*
|
|
||||||
|
|||||||
13
.npmignore
13
.npmignore
@ -1,10 +1,3 @@
|
|||||||
test
|
make
|
||||||
.nyc_output
|
src/useragents.js
|
||||||
coverage
|
Makefile
|
||||||
**/.*
|
|
||||||
node_modules
|
|
||||||
.github
|
|
||||||
docs
|
|
||||||
*.gz
|
|
||||||
jsdoc.json
|
|
||||||
webpack.config.js
|
|
||||||
|
|||||||
10
.nycrc
10
.nycrc
@ -1,10 +0,0 @@
|
|||||||
{
|
|
||||||
"sourceMap": false,
|
|
||||||
"instrument": false,
|
|
||||||
"include": [
|
|
||||||
"src/**/*.js"
|
|
||||||
],
|
|
||||||
"exclude": [
|
|
||||||
"*.js"
|
|
||||||
]
|
|
||||||
}
|
|
||||||
14
.testem.json
14
.testem.json
@ -1,14 +0,0 @@
|
|||||||
{
|
|
||||||
"framework": "custom",
|
|
||||||
"src_files": [
|
|
||||||
"src/**/*.js",
|
|
||||||
"test/**/*.js"
|
|
||||||
],
|
|
||||||
"launchers": {
|
|
||||||
"tap": {
|
|
||||||
"command": "ava test/**/*.js --tap",
|
|
||||||
"protocol": "tap"
|
|
||||||
}
|
|
||||||
},
|
|
||||||
"launch_in_dev": [ "tap" ]
|
|
||||||
}
|
|
||||||
8
.travis.yml
Normal file
8
.travis.yml
Normal file
@ -0,0 +1,8 @@
|
|||||||
|
language: node_js
|
||||||
|
node_js:
|
||||||
|
- "4.4.7"
|
||||||
|
notifications:
|
||||||
|
email:
|
||||||
|
- dustin@dustindiaz.com
|
||||||
|
|
||||||
|
script: NODE_ENV=test ./node_modules/.bin/mocha --reporter spec
|
||||||
147
CHANGELOG.md
147
CHANGELOG.md
@ -1,152 +1,7 @@
|
|||||||
# Bowser Changelog
|
# 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
|
|
||||||
- [FIX] Add support for Maxthon desktop browser (#246)
|
|
||||||
- [FIX] Add support for Swing browser (#248)
|
|
||||||
- [DOCS] Regenerate docs
|
|
||||||
|
|
||||||
### 2.0.0-beta.1 (August 18, 2018)
|
|
||||||
- [ADD] Add loose version comparison to `Parser.compareVersion()` and `Parser.satisfies()`
|
|
||||||
- [CHORE] Add CONTRIBUTING.md
|
|
||||||
- [DOCS] Regenerate docs
|
|
||||||
|
|
||||||
### 2.0.0-alpha.4 (August 2, 2018)
|
|
||||||
- [DOCS] Fix usage docs (#238)
|
|
||||||
- [CHANGE] Make `./es5.js` the main file of the package (#239)
|
|
||||||
|
|
||||||
### 2.0.0-alpha.3 (July 22, 2018)
|
|
||||||
- [CHANGE] Rename split and rename `compiled.js` to `es5.js` and `bundled.js` (#231, #236, #237)
|
|
||||||
- [ADD] Add `Parser.some` (#235)
|
|
||||||
|
|
||||||
### 2.0.0-alpha.2 (July 17, 2018)
|
|
||||||
- [CHANGE] Make `src/bowser` main file instead of the bundled one
|
|
||||||
- [CHANGE] Move the bundled file to the root of the package to make it possible to `require('bowser/compiled')` (#231)
|
|
||||||
- [REMOVE] Remove `typings.d.ts` before stable release (#232)
|
|
||||||
- [FIX] Improve Nexus devices detection (#233)
|
|
||||||
|
|
||||||
### 2.0.0-alpha.1 (July 9, 2018)
|
|
||||||
- [ADD] `Bowser.getParser()`
|
|
||||||
- [ADD] `Bowser.parse`
|
|
||||||
- [ADD] `Parser` class which describes parsing process
|
|
||||||
- [CHANGE] Change bowser's returning object
|
|
||||||
- [REMOVE] Remove bower support
|
|
||||||
|
|
||||||
### 1.9.4 (June 28, 2018)
|
|
||||||
- [FIX] Fix NAVER Whale browser detection (#220)
|
|
||||||
- [FIX] Fix MZ Browser browser detection (#219)
|
|
||||||
- [FIX] Fix Firefox Focus browser detection (#191)
|
|
||||||
- [FIX] Fix webOS browser detection (#186)
|
|
||||||
|
|
||||||
### 1.9.3 (March 12, 2018)
|
|
||||||
- [FIX] Fix `typings.d.ts` — add `ipad`, `iphone`, `ipod` flags to the interface
|
|
||||||
|
|
||||||
### 1.9.2 (February 5, 2018)
|
|
||||||
- [FIX] Fix `typings.d.ts` — add `osname` flag to the interface
|
|
||||||
|
|
||||||
### 1.9.1 (December 22, 2017)
|
### 1.9.1 (December 22, 2017)
|
||||||
- [FIX] Fix `typings.d.ts` — add `chromium` flag to the interface
|
- [FIX] Fix `typings.d.ts` — add `chromium` flag to interface
|
||||||
|
|
||||||
### 1.9.0 (December 20, 2017)
|
### 1.9.0 (December 20, 2017)
|
||||||
- [ADD] Add a public method `.detect()` (#205)
|
- [ADD] Add a public method `.detect()` (#205)
|
||||||
|
|||||||
@ -1,5 +1,5 @@
|
|||||||
Template to report about browser detection issue
|
Template to report about browser detection issue
|
||||||
|
|
||||||
`window.navigator.userAgent` of the browser is: ...
|
`window.navigator.userAgent` of the browser is: ...
|
||||||
And it's detected like ...
|
And it's detected like a ...
|
||||||
However, the real name of the browser is ...
|
But real name of the browser is ...
|
||||||
16
Makefile
Normal file
16
Makefile
Normal file
@ -0,0 +1,16 @@
|
|||||||
|
boosh:
|
||||||
|
node make/build.js
|
||||||
|
|
||||||
|
REPORTER = spec
|
||||||
|
|
||||||
|
test:
|
||||||
|
@NODE_ENV=test ./node_modules/.bin/mocha \
|
||||||
|
--reporter $(REPORTER) \
|
||||||
|
|
||||||
|
test-w:
|
||||||
|
@NODE_ENV=test ./node_modules/.bin/mocha \
|
||||||
|
--reporter $(REPORTER) \
|
||||||
|
--growl \
|
||||||
|
--watch
|
||||||
|
|
||||||
|
.PHONY: test test-w
|
||||||
331
README.md
331
README.md
@ -1,177 +1,210 @@
|
|||||||
## Bowser
|
## Bowser
|
||||||
A small, fast and rich-API browser/platform/engine detector for both browser and node.
|
A Browser detector. Because sometimes, there is no other way, and not even good modern browsers always provide good feature detection mechanisms.
|
||||||
- **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.
|
|
||||||
|
|
||||||
Don't hesitate to support the project on Github or [OpenCollective](https://opencollective.com/bowser) if you like it ❤️ Also, contributors are always welcome!
|
[](https://travis-ci.org/lancedikson/bowser)
|
||||||
|
|
||||||
[](https://opencollective.com/bowser) [](https://travis-ci.org/lancedikson/bowser/) [](https://greenkeeper.io/) [](https://coveralls.io/github/lancedikson/bowser?branch=master) 
|
So... it works like this:
|
||||||
|
|
||||||
# Contents
|
``` js
|
||||||
- [Overview](#overview)
|
if (bowser.msie && bowser.version <= 6) {
|
||||||
- [Use cases](#use-cases)
|
alert('Hello China');
|
||||||
|
|
||||||
# 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. Check it out on this page: https://bowser-js.github.io/bowser-online/.
|
|
||||||
|
|
||||||
### ⚠️ Version 2.0 breaking changes ⚠️
|
|
||||||
|
|
||||||
Version 2.0 has drastically changed the API. All available methods are on the [docs page](https://bowser-js.github.io/bowser/docs/).
|
|
||||||
|
|
||||||
_For legacy code, check out the [1.x](https://github.com/lancedikson/bowser/tree/v1.x) branch and install it through `npm install bowser@1.9.4`._
|
|
||||||
|
|
||||||
# Use cases
|
|
||||||
|
|
||||||
First of all, require the library. This is a UMD Module, so it will work for AMD, TypeScript, ES6, and CommonJS module systems.
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
const Bowser = require("bowser"); // CommonJS
|
|
||||||
|
|
||||||
import * as Bowser from "bowser"; // TypeScript
|
|
||||||
|
|
||||||
import Bowser from "bowser"; // ES6 (and TypeScript with --esModuleInterop enabled)
|
|
||||||
```
|
|
||||||
|
|
||||||
By default, the exported version is the *ES5 transpiled version*, which **do not** include any 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.
|
|
||||||
|
|
||||||
You may need to use the source files, so they will be available in the package as well.
|
|
||||||
|
|
||||||
## 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 do it with Bowser:
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
const browser = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
|
|
||||||
console.log(`The current browser name is "${browser.getBrowserName()}"`);
|
|
||||||
// The current browser name is "Internet Explorer"
|
|
||||||
```
|
|
||||||
|
|
||||||
or
|
|
||||||
|
|
||||||
```javascript
|
|
||||||
const browser = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
console.log(browser.getBrowser());
|
|
||||||
|
|
||||||
// outputs
|
|
||||||
{
|
|
||||||
name: "Internet Explorer"
|
|
||||||
version: "11.0"
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
or
|
## 1.1.0 breaking changes
|
||||||
|
We don't save built script in the repo anymore. The main file (`src/bowser.js`) is available through NPM or Bower.
|
||||||
|
Also you can download minified file from [the release page](https://github.com/ded/bowser/releases).
|
||||||
|
|
||||||
```javascript
|
## 1.0.0 breaking changes
|
||||||
console.log(Bowser.parse(window.navigator.userAgent));
|
`browser = require('bowser').browser;` becomes `bowser = require('bowser');`
|
||||||
|
|
||||||
// outputs
|
---
|
||||||
{
|
|
||||||
browser: {
|
## API
|
||||||
name: "Internet Explorer"
|
|
||||||
version: "11.0"
|
### bowser`:Object`
|
||||||
},
|
Use it to get object with detected flags of your current browser.
|
||||||
os: {
|
|
||||||
name: "Windows"
|
### bowser._detect(ua `:String`)`:Object`
|
||||||
version: "NT 6.3"
|
Use it to get object with detected flags from User Agent string.
|
||||||
versionName: "8.1"
|
|
||||||
},
|
### bowser.check(minVersions`:Object`, strictMode`:Boolean`, [ua]`:String`)`:Boolean`
|
||||||
platform: {
|
Use it to check if browser is supported. In default non-strict mode any browser family not present in `minVersions` will pass the check (like Chrome in the third call in the sample bellow). When strict mode is enabled then any not specified browser family in `minVersions` will cause `check` to return `false` (in the sample it is the fourth call, the last one).
|
||||||
type: "desktop"
|
|
||||||
},
|
``` js
|
||||||
engine: {
|
/**
|
||||||
name: "Trident"
|
* in case of using IE10
|
||||||
version: "7.0"
|
*/
|
||||||
}
|
bowser.check({msie: "11"}); // true
|
||||||
|
bowser.check({msie: "9.0"}); // false
|
||||||
|
|
||||||
|
/**
|
||||||
|
* specific user agent
|
||||||
|
*/
|
||||||
|
bowser.check({chrome: "45"}, window.navigator.userAgent); // true
|
||||||
|
|
||||||
|
/**
|
||||||
|
* but false in strict mode
|
||||||
|
*/
|
||||||
|
bowser.check({chrome: "45"}, true, window.navigator.userAgent); // false
|
||||||
|
```
|
||||||
|
|
||||||
|
### bowser.compareVersions(versions`:Array<String>`)`:Number`
|
||||||
|
Use it to compare two versions.
|
||||||
|
|
||||||
|
``` js
|
||||||
|
bowser.compareVersions(['9.0', '10']);
|
||||||
|
// -1
|
||||||
|
```
|
||||||
|
|
||||||
|
### bowser.isUnsupportedBrowser(minVersions`:Object`, [strictMode]`:Boolean`, [ua]`:string`)`:Boolean`
|
||||||
|
Use it to check if browser is unsupported.
|
||||||
|
|
||||||
|
``` js
|
||||||
|
bowser.isUnsupportedBrowser({msie: "10"}, window.navigator.userAgent);
|
||||||
|
// true / false
|
||||||
|
```
|
||||||
|
|
||||||
|
See more examples in [tests](test/test.js).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Bowser Flags
|
||||||
|
Your mileage may vary, but these flags should be set. See Contributing below.
|
||||||
|
|
||||||
|
``` js
|
||||||
|
alert('Hello ' + bowser.name + ' ' + bowser.version);
|
||||||
|
```
|
||||||
|
|
||||||
|
### All detected browsers
|
||||||
|
These flags are set for all detected browsers:
|
||||||
|
|
||||||
|
* `name` - A human readable name for this browser. E.g. 'Chrome', ''
|
||||||
|
* `version` - Version number for the browser. E.g. '32.0'
|
||||||
|
|
||||||
|
For unknown browsers, Bowser makes a best guess from the UA string. So, these may not be set.
|
||||||
|
|
||||||
|
### Rendering engine flags
|
||||||
|
If detected, one of these flags may be set to true:
|
||||||
|
|
||||||
|
* `webkit` - Chrome 0-27, Android <4.4, iOs, BB, etc.
|
||||||
|
* `blink` - Chrome >=28, Android >=4.4, Opera, etc.
|
||||||
|
* `gecko` - Firefox, etc.
|
||||||
|
* `msie` - IE <= 11
|
||||||
|
* `msedge` - IE > 11
|
||||||
|
|
||||||
|
Safari, Chrome and some other minor browsers will report that they have `webkit` engines.
|
||||||
|
Firefox and Seamonkey will report that they have `gecko` engines.
|
||||||
|
|
||||||
|
``` js
|
||||||
|
if (bowser.webkit) {
|
||||||
|
// do stuff with safari & chrome & opera & android & blackberry & webos & silk
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Device flags
|
||||||
|
If detected, one of these flags may be set to true:
|
||||||
|
|
||||||
## Filtering browsers
|
* `mobile` - All detected mobile OSes are additionally flagged `mobile`, **unless it's a tablet**
|
||||||
|
* `tablet` - If a tablet device is detected, the flag `tablet` is **set instead of `mobile`**.
|
||||||
|
|
||||||
You could want to filter some particular browsers to provide any special support for them or make any workarounds.
|
### Browser flags
|
||||||
It could look like this:
|
If detected, one of these flags may be set to true. The rendering engine flag is shown in []'s:
|
||||||
|
|
||||||
```javascript
|
* `chrome` - [`webkit`|`blink`]
|
||||||
const browser = Bowser.getParser(window.navigator.userAgent);
|
* `chromium` - [`webkit`|`blink`]
|
||||||
const isValidBrowser = browser.satisfies({
|
* `firefox` - [`gecko`]
|
||||||
// declare browsers per OS
|
* `msie`
|
||||||
windows: {
|
* `msedge`
|
||||||
"internet explorer": ">10",
|
* `safari` - [`webkit`]
|
||||||
},
|
* `android` - native browser - [`webkit`|`blink`]
|
||||||
macos: {
|
* `ios` - native browser - [`webkit`]
|
||||||
safari: ">10.1"
|
* `opera` - [`blink` if >=15]
|
||||||
},
|
* `samsungBrowser` - [`blink`]
|
||||||
|
* `phantom` - [`webkit`]
|
||||||
|
* `blackberry` - native browser - [`webkit`]
|
||||||
|
* `webos` - native browser - [`webkit`]
|
||||||
|
* `silk` - Amazon Kindle browser - [`webkit`]
|
||||||
|
* `bada` - [`webkit`]
|
||||||
|
* `tizen` - [`webkit`]
|
||||||
|
* `seamonkey` - [`gecko`]
|
||||||
|
* `sailfish` - [`gecko`]
|
||||||
|
* `ucbrowser` — [`webkit`]
|
||||||
|
* `qupzilla` — [`webkit`]
|
||||||
|
* `vivaldi` — [`blink`]
|
||||||
|
* `sleipnir` — [`blink`]
|
||||||
|
* `kMeleon` — [`gecko`]
|
||||||
|
|
||||||
// per platform (mobile, desktop or tablet)
|
For all detected browsers the browser version is set in the `version` field.
|
||||||
mobile: {
|
|
||||||
safari: '>=9',
|
|
||||||
'android browser': '>3.10'
|
|
||||||
},
|
|
||||||
|
|
||||||
// or in general
|
### OS Flags
|
||||||
chrome: "~20.1.1432",
|
If detected, one of these flags may be set to true:
|
||||||
firefox: ">31",
|
|
||||||
opera: ">=22",
|
|
||||||
|
|
||||||
// also supports equality operator
|
* `mac`
|
||||||
chrome: "=20.1.1432", // will match particular build only
|
* `windows` - other than Windows Phone
|
||||||
|
* `windowsphone`
|
||||||
|
* `linux` - other than `android`, `chromeos`, `webos`, `tizen`, and `sailfish`
|
||||||
|
* `chromeos`
|
||||||
|
* `android`
|
||||||
|
* `ios` - also sets one of `iphone`/`ipad`/`ipod`
|
||||||
|
* `blackberry`
|
||||||
|
* `firefoxos`
|
||||||
|
* `webos` - may also set `touchpad`
|
||||||
|
* `bada`
|
||||||
|
* `tizen`
|
||||||
|
* `sailfish`
|
||||||
|
|
||||||
// and loose-equality operator
|
`osname` and `osversion` may also be set:
|
||||||
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)
|
* `osname` - for the OS flags detected above: macOS, Windows, Windows Phone, Linux, Chrome OS, Android, iOS, Blackberry OS, Firefox OS, WebOS, Bada, Tizen, Sailfish OS, and Xbox
|
||||||
});
|
* `osversion` - for Android, iOS, MacOS, Windows, Windows Phone, WebOS, Bada, and Tizen. If included in UA string.
|
||||||
|
|
||||||
|
iOS is always reported as `ios` and additionally as `iphone`/`ipad`/`ipod`, whichever one matches best.
|
||||||
|
If WebOS device is an HP TouchPad the flag `touchpad` is additionally set.
|
||||||
|
|
||||||
|
### Browser capability grading
|
||||||
|
One of these flags may be set:
|
||||||
|
|
||||||
|
* `a` - This browser has full capabilities
|
||||||
|
* `c` - This browser has degraded capabilities. Serve simpler version
|
||||||
|
* `x` - This browser has minimal capabilities and is probably not well detected.
|
||||||
|
|
||||||
|
There is no `b`. For unknown browsers, none of these flags may be set.
|
||||||
|
|
||||||
|
### Ender Support
|
||||||
|
|
||||||
|
`package.json`
|
||||||
|
|
||||||
|
``` json
|
||||||
|
"dependencies": {
|
||||||
|
"bowser": "x.x.x"
|
||||||
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Settings for any particular OS or platform has more priority and redefines settings of standalone browsers.
|
``` js
|
||||||
Thus, you can define OS or platform specific rules and they will have more priority in the end.
|
if (require('bowser').chrome) {
|
||||||
|
alert('Hello Silicon Valley')
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
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
|
||||||
|
$ make test
|
||||||
|
```
|
||||||
|
|
||||||
By default you are supposed to use the full browser name for `.satisfies`.
|
Please do not check-in the built files `bowser.js` and `bowser.min.js` in pull requests.
|
||||||
But, there's a short way to define a browser using short aliases. The full
|
|
||||||
list of aliases can be found in [the file](src/constants.js).
|
|
||||||
|
|
||||||
## Similar Projects
|
### Adding tests
|
||||||
|
See the list in `src/useragents.js` 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
|
||||||
* [Kong](https://github.com/BigBadBleuCheese/Kong) - A C# port of Bowser.
|
* [Kong](https://github.com/BigBadBleuCheese/Kong) - A C# port of Bowser.
|
||||||
|
|
||||||
## Contributors
|
### License
|
||||||
|
|
||||||
### 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.
|
Licensed as MIT. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.
|
||||||
|
|||||||
33
bower.json
Normal file
33
bower.json
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
{
|
||||||
|
"name": "bowser",
|
||||||
|
"description": "Lightweight browser detector",
|
||||||
|
"keywords": [
|
||||||
|
"browser",
|
||||||
|
"useragent",
|
||||||
|
"user-agent",
|
||||||
|
"parser",
|
||||||
|
"ua",
|
||||||
|
"detection",
|
||||||
|
"ender",
|
||||||
|
"sniff"
|
||||||
|
],
|
||||||
|
"version": "1.9.0",
|
||||||
|
"homepage": "https://github.com/lancedikson/bowser",
|
||||||
|
"scripts": [
|
||||||
|
"src/bowser.js"
|
||||||
|
],
|
||||||
|
"authors": [
|
||||||
|
"Dustin Diaz <dustin@dustindiaz.com> (http://dustindiaz.com)",
|
||||||
|
"Denis Demchenko <lance@dikson.me>"
|
||||||
|
],
|
||||||
|
"moduleType": [],
|
||||||
|
"license": "MIT",
|
||||||
|
"main": "src/bowser.js",
|
||||||
|
"ignore": [
|
||||||
|
"node_modules",
|
||||||
|
"test",
|
||||||
|
"make",
|
||||||
|
"**/.*",
|
||||||
|
"Makefile"
|
||||||
|
]
|
||||||
|
}
|
||||||
505
docs/Bowser.html
505
docs/Bowser.html
@ -1,505 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<head>
|
|
||||||
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<title>Bowser - 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="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">
|
|
||||||
|
|
||||||
<h1 class="page-title">Bowser</h1>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<section>
|
|
||||||
|
|
||||||
<header>
|
|
||||||
|
|
||||||
<h2>
|
|
||||||
Bowser
|
|
||||||
</h2>
|
|
||||||
|
|
||||||
<div class="class-description"><p>Bowser is a static object, that provides an API to the Parsers</p></div>
|
|
||||||
|
|
||||||
|
|
||||||
</header>
|
|
||||||
|
|
||||||
<article>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h3 class="subsection-title">Methods</h3>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h4 class="name" id=".getParser"><span class="type-signature">(static) </span>getParser<span class="signature">(UA, skipParsing<span class="signature-attributes">opt</span>)</span><span class="type-signature"> → {<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="bowser.js.html">bowser.js</a>, <a href="bowser.js.html#line40">line 40</a>
|
|
||||||
</li></ul></dd>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</dl>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<div class="description">
|
|
||||||
<p>Creates a <a href="Parser.html">Parser</a> instance</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h5>Example</h5>
|
|
||||||
|
|
||||||
<pre class="prettyprint"><code>const parser = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
const result = parser.getResult();</code></pre>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<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>UA</code></td>
|
|
||||||
|
|
||||||
|
|
||||||
<td class="type">
|
|
||||||
|
|
||||||
|
|
||||||
<span class="param-type">String</span>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</td>
|
|
||||||
|
|
||||||
|
|
||||||
<td class="attributes">
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</td>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<td class="default">
|
|
||||||
|
|
||||||
</td>
|
|
||||||
|
|
||||||
|
|
||||||
<td class="description last"><p>UserAgent string</p></td>
|
|
||||||
</tr>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<tr>
|
|
||||||
|
|
||||||
<td class="name"><code>skipParsing</code></td>
|
|
||||||
|
|
||||||
|
|
||||||
<td class="type">
|
|
||||||
|
|
||||||
|
|
||||||
<span class="param-type">Boolean</span>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</td>
|
|
||||||
|
|
||||||
|
|
||||||
<td class="attributes">
|
|
||||||
|
|
||||||
<optional><br>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</td>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<td class="default">
|
|
||||||
|
|
||||||
<code>false</code>
|
|
||||||
|
|
||||||
</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>
|
|
||||||
|
|
||||||
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h5>Throws:</h5>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<dl>
|
|
||||||
<dt>
|
|
||||||
<div class="param-desc">
|
|
||||||
<p>when UA is not a String</p>
|
|
||||||
</div>
|
|
||||||
</dt>
|
|
||||||
<dd></dd>
|
|
||||||
<dt>
|
|
||||||
<dl class="param-type">
|
|
||||||
<dt>
|
|
||||||
Type
|
|
||||||
</dt>
|
|
||||||
<dd>
|
|
||||||
|
|
||||||
<span class="param-type">Error</span>
|
|
||||||
|
|
||||||
|
|
||||||
</dd>
|
|
||||||
</dl>
|
|
||||||
</dt>
|
|
||||||
<dd></dd>
|
|
||||||
</dl>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h5>Returns:</h5>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<dl class="param-type">
|
|
||||||
<dt>
|
|
||||||
Type
|
|
||||||
</dt>
|
|
||||||
<dd>
|
|
||||||
|
|
||||||
<span class="param-type"><a href="Parser.html">Parser</a></span>
|
|
||||||
|
|
||||||
|
|
||||||
</dd>
|
|
||||||
</dl>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h4 class="name" id=".parse"><span class="type-signature">(static) </span>parse<span class="signature">(UA)</span><span class="type-signature"> → {<a href="global.html#ParsedResult">ParsedResult</a>}</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#line56">line 56</a>
|
|
||||||
</li></ul></dd>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</dl>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<div class="description">
|
|
||||||
<p>Creates a <a href="Parser.html">Parser</a> instance and runs Parser.getResult immediately</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h5>Example</h5>
|
|
||||||
|
|
||||||
<pre class="prettyprint"><code>const result = Bowser.parse(window.navigator.userAgent);</code></pre>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h5>Parameters:</h5>
|
|
||||||
|
|
||||||
|
|
||||||
<table class="params">
|
|
||||||
<thead>
|
|
||||||
<tr>
|
|
||||||
|
|
||||||
<th>Name</th>
|
|
||||||
|
|
||||||
|
|
||||||
<th>Type</th>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<th class="last">Description</th>
|
|
||||||
</tr>
|
|
||||||
</thead>
|
|
||||||
|
|
||||||
<tbody>
|
|
||||||
|
|
||||||
|
|
||||||
<tr>
|
|
||||||
|
|
||||||
<td class="name"><code>UA</code></td>
|
|
||||||
|
|
||||||
|
|
||||||
<td class="type">
|
|
||||||
|
|
||||||
</td>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<td class="description last"></td>
|
|
||||||
</tr>
|
|
||||||
|
|
||||||
|
|
||||||
</tbody>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<h5>Returns:</h5>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<dl class="param-type">
|
|
||||||
<dt>
|
|
||||||
Type
|
|
||||||
</dt>
|
|
||||||
<dd>
|
|
||||||
|
|
||||||
<span class="param-type"><a href="global.html#ParsedResult">ParsedResult</a></span>
|
|
||||||
|
|
||||||
|
|
||||||
</dd>
|
|
||||||
</dl>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</article>
|
|
||||||
|
|
||||||
</section>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br class="clear">
|
|
||||||
|
|
||||||
<footer>
|
|
||||||
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>
|
|
||||||
@ -1,234 +0,0 @@
|
|||||||
<!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>
|
|
||||||
3142
docs/Parser.html
3142
docs/Parser.html
File diff suppressed because it is too large
Load Diff
@ -1,146 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<head>
|
|
||||||
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<title>bowser.js - 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="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">
|
|
||||||
|
|
||||||
<h1 class="page-title">bowser.js</h1>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<section>
|
|
||||||
<article>
|
|
||||||
<pre class="prettyprint source linenums"><code>/*!
|
|
||||||
* Bowser - a browser detector
|
|
||||||
* https://github.com/lancedikson/bowser
|
|
||||||
* MIT License | (c) Dustin Diaz 2012-2015
|
|
||||||
* MIT License | (c) Denis Demchenko 2015-2019
|
|
||||||
*/
|
|
||||||
import Parser from './parser.js';
|
|
||||||
import {
|
|
||||||
BROWSER_MAP,
|
|
||||||
ENGINE_MAP,
|
|
||||||
OS_MAP,
|
|
||||||
PLATFORMS_MAP,
|
|
||||||
} from './constants.js';
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Bowser class.
|
|
||||||
* Keep it simple as much as it can be.
|
|
||||||
* 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 Parser} instance
|
|
||||||
*
|
|
||||||
* @param {String} UA UserAgent string
|
|
||||||
* @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 parser = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
* const result = parser.getResult();
|
|
||||||
*/
|
|
||||||
static getParser(UA, skipParsing = false) {
|
|
||||||
if (typeof UA !== 'string') {
|
|
||||||
throw new Error('UserAgent should be a string');
|
|
||||||
}
|
|
||||||
return new Parser(UA, skipParsing);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Creates a {@link Parser} instance and runs {@link Parser.getResult} immediately
|
|
||||||
*
|
|
||||||
* @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;
|
|
||||||
</code></pre>
|
|
||||||
</article>
|
|
||||||
</section>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br class="clear">
|
|
||||||
|
|
||||||
<footer>
|
|
||||||
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>
|
|
||||||
2719
docs/global.html
2719
docs/global.html
File diff suppressed because it is too large
Load Diff
223
docs/index.html
223
docs/index.html
@ -1,223 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<head>
|
|
||||||
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<title>Home - 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="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">
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<section class="package">
|
|
||||||
<h3> </h3>
|
|
||||||
</section>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<section class="readme">
|
|
||||||
<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. 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("bowser"); // CommonJS
|
|
||||||
|
|
||||||
import * as Bowser from "bowser"; // TypeScript
|
|
||||||
|
|
||||||
import Bowser from "bowser"; // ES6 (and TypeScript with --esModuleInterop enabled)
|
|
||||||
</code></pre>
|
|
||||||
<p>By default, the exported version is the <em>ES5 transpiled version</em>, which <strong>do not</strong> include any polyfills.</p>
|
|
||||||
<p>In case you don't use your own <code>babel-polyfill</code> you may need to have pre-built bundle with all needed polyfills.
|
|
||||||
So, for you it's suitable to require bowser like this: <code>require('bowser/bundled')</code>.
|
|
||||||
As the result, you get a ES5 version of bowser with <code>babel-polyfill</code> bundled together.</p>
|
|
||||||
<p>You may need to use the source files, so they will be available in the package as well.</p>
|
|
||||||
<h2>Browser props detection</h2>
|
|
||||||
<p>Often we need to pick users' browser properties such as the name, the version, the rendering engine and so on. Here is an example how to do it with Bowser:</p>
|
|
||||||
<pre class="prettyprint source lang-javascript"><code>const browser = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
|
|
||||||
console.log(`The current browser name is "${browser.getBrowserName()}"`);
|
|
||||||
// The current browser name is "Internet Explorer"
|
|
||||||
</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: "Internet Explorer"
|
|
||||||
version: "11.0"
|
|
||||||
}
|
|
||||||
</code></pre>
|
|
||||||
<p>or</p>
|
|
||||||
<pre class="prettyprint source lang-javascript"><code>console.log(Bowser.parse(window.navigator.userAgent));
|
|
||||||
|
|
||||||
// outputs
|
|
||||||
{
|
|
||||||
browser: {
|
|
||||||
name: "Internet Explorer"
|
|
||||||
version: "11.0"
|
|
||||||
},
|
|
||||||
os: {
|
|
||||||
name: "Windows"
|
|
||||||
version: "NT 6.3"
|
|
||||||
versionName: "8.1"
|
|
||||||
},
|
|
||||||
platform: {
|
|
||||||
type: "desktop"
|
|
||||||
},
|
|
||||||
engine: {
|
|
||||||
name: "Trident"
|
|
||||||
version: "7.0"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
</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);
|
|
||||||
const isValidBrowser = browser.satisfies({
|
|
||||||
// declare browsers per OS
|
|
||||||
windows: {
|
|
||||||
"internet explorer": ">10",
|
|
||||||
},
|
|
||||||
macos: {
|
|
||||||
safari: ">10.1"
|
|
||||||
},
|
|
||||||
|
|
||||||
// per platform (mobile, desktop or tablet)
|
|
||||||
mobile: {
|
|
||||||
safari: '>=9',
|
|
||||||
'android browser': '>3.10'
|
|
||||||
},
|
|
||||||
|
|
||||||
// or in general
|
|
||||||
chrome: "~20.1.1432",
|
|
||||||
firefox: ">31",
|
|
||||||
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.1" // 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.
|
|
||||||
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>
|
|
||||||
<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>
|
|
||||||
<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>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br class="clear">
|
|
||||||
|
|
||||||
<footer>
|
|
||||||
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>
|
|
||||||
@ -1,565 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<head>
|
|
||||||
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<title>parser.js - 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="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">
|
|
||||||
|
|
||||||
<h1 class="page-title">parser.js</h1>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<section>
|
|
||||||
<article>
|
|
||||||
<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.
|
|
||||||
*/
|
|
||||||
class Parser {
|
|
||||||
/**
|
|
||||||
* Create instance of Parser
|
|
||||||
*
|
|
||||||
* @param {String} UA User-Agent string
|
|
||||||
* @param {Boolean} [skipParsing=false] parser can skip parsing in purpose of performance
|
|
||||||
* improvements if you need to make a more particular parsing
|
|
||||||
* like {@link Parser#parseBrowser} or {@link Parser#parsePlatform}
|
|
||||||
*
|
|
||||||
* @throw {Error} in case of empty UA String
|
|
||||||
*
|
|
||||||
* @constructor
|
|
||||||
*/
|
|
||||||
constructor(UA, skipParsing = false) {
|
|
||||||
if (UA === void (0) || UA === null || UA === '') {
|
|
||||||
throw new Error("UserAgent parameter can't be empty");
|
|
||||||
}
|
|
||||||
|
|
||||||
this._ua = UA;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @typedef ParsedResult
|
|
||||||
* @property {Object} browser
|
|
||||||
* @property {String|undefined} [browser.name]
|
|
||||||
* Browser name, like `"Chrome"` or `"Internet Explorer"`
|
|
||||||
* @property {String|undefined} [browser.version] Browser version as a String `"12.01.45334.10"`
|
|
||||||
* @property {Object} os
|
|
||||||
* @property {String|undefined} [os.name] OS name, like `"Windows"` or `"macOS"`
|
|
||||||
* @property {String|undefined} [os.version] OS version, like `"NT 5.1"` or `"10.11.1"`
|
|
||||||
* @property {String|undefined} [os.versionName] OS name, like `"XP"` or `"High Sierra"`
|
|
||||||
* @property {Object} platform
|
|
||||||
* @property {String|undefined} [platform.type]
|
|
||||||
* platform type, can be either `"desktop"`, `"tablet"` or `"mobile"`
|
|
||||||
* @property {String|undefined} [platform.vendor] Vendor of the device,
|
|
||||||
* like `"Apple"` or `"Samsung"`
|
|
||||||
* @property {String|undefined} [platform.model] Device model,
|
|
||||||
* like `"iPhone"` or `"Kindle Fire HD 7"`
|
|
||||||
* @property {Object} engine
|
|
||||||
* @property {String|undefined} [engine.name]
|
|
||||||
* Can be any of this: `WebKit`, `Blink`, `Gecko`, `Trident`, `Presto`, `EdgeHTML`
|
|
||||||
* @property {String|undefined} [engine.version] String version of the engine
|
|
||||||
*/
|
|
||||||
this.parsedResult = {};
|
|
||||||
|
|
||||||
if (skipParsing !== true) {
|
|
||||||
this.parse();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get UserAgent string of current Parser instance
|
|
||||||
* @return {String} User-Agent String of the current <Parser> object
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getUA() {
|
|
||||||
return this._ua;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Test a UA string for a regexp
|
|
||||||
* @param {RegExp} regex
|
|
||||||
* @return {Boolean}
|
|
||||||
*/
|
|
||||||
test(regex) {
|
|
||||||
return regex.test(this._ua);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed browser object
|
|
||||||
* @return {Object}
|
|
||||||
*/
|
|
||||||
parseBrowser() {
|
|
||||||
this.parsedResult.browser = {};
|
|
||||||
|
|
||||||
const browserDescriptor = Utils.find(browserParsersList, (_browser) => {
|
|
||||||
if (typeof _browser.test === 'function') {
|
|
||||||
return _browser.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (_browser.test instanceof Array) {
|
|
||||||
return _browser.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (browserDescriptor) {
|
|
||||||
this.parsedResult.browser = browserDescriptor.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.browser;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed browser object
|
|
||||||
* @return {Object}
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getBrowser() {
|
|
||||||
if (this.parsedResult.browser) {
|
|
||||||
return this.parsedResult.browser;
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parseBrowser();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get browser's name
|
|
||||||
* @return {String} Browser's name or an empty string
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getBrowserName(toLowerCase) {
|
|
||||||
if (toLowerCase) {
|
|
||||||
return String(this.getBrowser().name).toLowerCase() || '';
|
|
||||||
}
|
|
||||||
return this.getBrowser().name || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get browser's version
|
|
||||||
* @return {String} version of browser
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getBrowserVersion() {
|
|
||||||
return this.getBrowser().version;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get OS
|
|
||||||
* @return {Object}
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* this.getOS();
|
|
||||||
* {
|
|
||||||
* name: 'macOS',
|
|
||||||
* version: '10.11.12'
|
|
||||||
* }
|
|
||||||
*/
|
|
||||||
getOS() {
|
|
||||||
if (this.parsedResult.os) {
|
|
||||||
return this.parsedResult.os;
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parseOS();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse OS and save it to this.parsedResult.os
|
|
||||||
* @return {*|{}}
|
|
||||||
*/
|
|
||||||
parseOS() {
|
|
||||||
this.parsedResult.os = {};
|
|
||||||
|
|
||||||
const os = Utils.find(osParsersList, (_os) => {
|
|
||||||
if (typeof _os.test === 'function') {
|
|
||||||
return _os.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (_os.test instanceof Array) {
|
|
||||||
return _os.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (os) {
|
|
||||||
this.parsedResult.os = os.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.os;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get OS name
|
|
||||||
* @param {Boolean} [toLowerCase] return lower-cased value
|
|
||||||
* @return {String} name of the OS — macOS, Windows, Linux, etc.
|
|
||||||
*/
|
|
||||||
getOSName(toLowerCase) {
|
|
||||||
const { name } = this.getOS();
|
|
||||||
|
|
||||||
if (toLowerCase) {
|
|
||||||
return String(name).toLowerCase() || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
return name || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get OS version
|
|
||||||
* @return {String} full version with dots ('10.11.12', '5.6', etc)
|
|
||||||
*/
|
|
||||||
getOSVersion() {
|
|
||||||
return this.getOS().version;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed platform
|
|
||||||
* @return {{}}
|
|
||||||
*/
|
|
||||||
getPlatform() {
|
|
||||||
if (this.parsedResult.platform) {
|
|
||||||
return this.parsedResult.platform;
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsePlatform();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get platform name
|
|
||||||
* @param {Boolean} [toLowerCase=false]
|
|
||||||
* @return {*}
|
|
||||||
*/
|
|
||||||
getPlatformType(toLowerCase = false) {
|
|
||||||
const { type } = this.getPlatform();
|
|
||||||
|
|
||||||
if (toLowerCase) {
|
|
||||||
return String(type).toLowerCase() || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
return type || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed platform
|
|
||||||
* @return {{}}
|
|
||||||
*/
|
|
||||||
parsePlatform() {
|
|
||||||
this.parsedResult.platform = {};
|
|
||||||
|
|
||||||
const platform = Utils.find(platformParsersList, (_platform) => {
|
|
||||||
if (typeof _platform.test === 'function') {
|
|
||||||
return _platform.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (_platform.test instanceof Array) {
|
|
||||||
return _platform.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (platform) {
|
|
||||||
this.parsedResult.platform = platform.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.platform;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed engine
|
|
||||||
* @return {{}}
|
|
||||||
*/
|
|
||||||
getEngine() {
|
|
||||||
if (this.parsedResult.engine) {
|
|
||||||
return this.parsedResult.engine;
|
|
||||||
}
|
|
||||||
|
|
||||||
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 {{}}
|
|
||||||
*/
|
|
||||||
parseEngine() {
|
|
||||||
this.parsedResult.engine = {};
|
|
||||||
|
|
||||||
const engine = Utils.find(enginesParsersList, (_engine) => {
|
|
||||||
if (typeof _engine.test === 'function') {
|
|
||||||
return _engine.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (_engine.test instanceof Array) {
|
|
||||||
return _engine.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (engine) {
|
|
||||||
this.parsedResult.engine = engine.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.engine;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse full information about the browser
|
|
||||||
* @returns {Parser}
|
|
||||||
*/
|
|
||||||
parse() {
|
|
||||||
this.parseBrowser();
|
|
||||||
this.parseOS();
|
|
||||||
this.parsePlatform();
|
|
||||||
this.parseEngine();
|
|
||||||
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed result
|
|
||||||
* @return {ParsedResult}
|
|
||||||
*/
|
|
||||||
getResult() {
|
|
||||||
return Utils.assign({}, this.parsedResult);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if parsed browser matches certain conditions
|
|
||||||
*
|
|
||||||
* @param {Object} 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 = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
* if (browser.satisfies({chrome: '>118.01.1322' }))
|
|
||||||
* // or with os
|
|
||||||
* if (browser.satisfies({windows: { chrome: '>118.01.1322' } }))
|
|
||||||
* // or with platforms
|
|
||||||
* if (browser.satisfies({desktop: { chrome: '>118.01.1322' } }))
|
|
||||||
*/
|
|
||||||
satisfies(checkTree) {
|
|
||||||
const platformsAndOSes = {};
|
|
||||||
let platformsAndOSCounter = 0;
|
|
||||||
const browsers = {};
|
|
||||||
let browsersCounter = 0;
|
|
||||||
|
|
||||||
const allDefinitions = Object.keys(checkTree);
|
|
||||||
|
|
||||||
allDefinitions.forEach((key) => {
|
|
||||||
const currentDefinition = checkTree[key];
|
|
||||||
if (typeof currentDefinition === 'string') {
|
|
||||||
browsers[key] = currentDefinition;
|
|
||||||
browsersCounter += 1;
|
|
||||||
} else if (typeof currentDefinition === 'object') {
|
|
||||||
platformsAndOSes[key] = currentDefinition;
|
|
||||||
platformsAndOSCounter += 1;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (platformsAndOSCounter > 0) {
|
|
||||||
const platformsAndOSNames = Object.keys(platformsAndOSes);
|
|
||||||
const OSMatchingDefinition = Utils.find(platformsAndOSNames, name => (this.isOS(name)));
|
|
||||||
|
|
||||||
if (OSMatchingDefinition) {
|
|
||||||
const osResult = this.satisfies(platformsAndOSes[OSMatchingDefinition]);
|
|
||||||
|
|
||||||
if (osResult !== void 0) {
|
|
||||||
return osResult;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const platformMatchingDefinition = Utils.find(
|
|
||||||
platformsAndOSNames,
|
|
||||||
name => (this.isPlatform(name)),
|
|
||||||
);
|
|
||||||
if (platformMatchingDefinition) {
|
|
||||||
const platformResult = this.satisfies(platformsAndOSes[platformMatchingDefinition]);
|
|
||||||
|
|
||||||
if (platformResult !== void 0) {
|
|
||||||
return platformResult;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (browsersCounter > 0) {
|
|
||||||
const browserNames = Object.keys(browsers);
|
|
||||||
const matchingDefinition = Utils.find(browserNames, name => (this.isBrowser(name, true)));
|
|
||||||
|
|
||||||
if (matchingDefinition !== void 0) {
|
|
||||||
return this.compareVersion(browsers[matchingDefinition]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return undefined;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 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 && alias) {
|
|
||||||
browserNameLower = alias.toLowerCase();
|
|
||||||
}
|
|
||||||
return browserNameLower === defaultBrowserName;
|
|
||||||
}
|
|
||||||
|
|
||||||
compareVersion(version) {
|
|
||||||
let expectedResults = [0];
|
|
||||||
let comparableVersion = version;
|
|
||||||
let isLoose = false;
|
|
||||||
|
|
||||||
const currentBrowserVersion = this.getBrowserVersion();
|
|
||||||
|
|
||||||
if (typeof currentBrowserVersion !== 'string') {
|
|
||||||
return void 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
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] === '~') {
|
|
||||||
isLoose = true;
|
|
||||||
comparableVersion = version.substr(1);
|
|
||||||
}
|
|
||||||
|
|
||||||
return expectedResults.indexOf(
|
|
||||||
Utils.compareVersions(currentBrowserVersion, comparableVersion, isLoose),
|
|
||||||
) > -1;
|
|
||||||
}
|
|
||||||
|
|
||||||
isOS(osName) {
|
|
||||||
return this.getOSName(true) === String(osName).toLowerCase();
|
|
||||||
}
|
|
||||||
|
|
||||||
isPlatform(platformType) {
|
|
||||||
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, includingAlias = false) {
|
|
||||||
return this.isBrowser(anything, includingAlias) || this.isOS(anything)
|
|
||||||
|| this.isPlatform(anything);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if any of the given values satisfies this.is(anything)
|
|
||||||
* @param {String[]} anythings
|
|
||||||
* @returns {Boolean}
|
|
||||||
*/
|
|
||||||
some(anythings = []) {
|
|
||||||
return anythings.some(anything => this.is(anything));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export default Parser;
|
|
||||||
</code></pre>
|
|
||||||
</article>
|
|
||||||
</section>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br class="clear">
|
|
||||||
|
|
||||||
<footer>
|
|
||||||
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>
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
function hideAllButCurrent(){
|
|
||||||
//by default all submenut items are hidden
|
|
||||||
//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().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";
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
|
|
||||||
hideAllButCurrent();
|
|
||||||
4
docs/scripts/jquery-3.1.1.min.js
vendored
4
docs/scripts/jquery-3.1.1.min.js
vendored
File diff suppressed because one or more lines are too long
@ -1,25 +0,0 @@
|
|||||||
/*global document */
|
|
||||||
(function() {
|
|
||||||
var source = document.getElementsByClassName('prettyprint source linenums');
|
|
||||||
var i = 0;
|
|
||||||
var lineNumber = 0;
|
|
||||||
var lineId;
|
|
||||||
var lines;
|
|
||||||
var totalLines;
|
|
||||||
var anchorHash;
|
|
||||||
|
|
||||||
if (source && source[0]) {
|
|
||||||
anchorHash = document.location.hash.substring(1);
|
|
||||||
lines = source[0].getElementsByTagName('li');
|
|
||||||
totalLines = lines.length;
|
|
||||||
|
|
||||||
for (; i < totalLines; i++) {
|
|
||||||
lineNumber++;
|
|
||||||
lineId = 'line' + lineNumber;
|
|
||||||
lines[i].id = lineId;
|
|
||||||
if (lineId === anchorHash) {
|
|
||||||
lines[i].className += ' selected';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
})();
|
|
||||||
@ -1,12 +0,0 @@
|
|||||||
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();
|
|
||||||
@ -1,4 +0,0 @@
|
|||||||
//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;
|
|
||||||
}
|
|
||||||
@ -1,202 +0,0 @@
|
|||||||
|
|
||||||
Apache License
|
|
||||||
Version 2.0, January 2004
|
|
||||||
http://www.apache.org/licenses/
|
|
||||||
|
|
||||||
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
||||||
|
|
||||||
1. Definitions.
|
|
||||||
|
|
||||||
"License" shall mean the terms and conditions for use, reproduction,
|
|
||||||
and distribution as defined by Sections 1 through 9 of this document.
|
|
||||||
|
|
||||||
"Licensor" shall mean the copyright owner or entity authorized by
|
|
||||||
the copyright owner that is granting the License.
|
|
||||||
|
|
||||||
"Legal Entity" shall mean the union of the acting entity and all
|
|
||||||
other entities that control, are controlled by, or are under common
|
|
||||||
control with that entity. For the purposes of this definition,
|
|
||||||
"control" means (i) the power, direct or indirect, to cause the
|
|
||||||
direction or management of such entity, whether by contract or
|
|
||||||
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
||||||
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
||||||
|
|
||||||
"You" (or "Your") shall mean an individual or Legal Entity
|
|
||||||
exercising permissions granted by this License.
|
|
||||||
|
|
||||||
"Source" form shall mean the preferred form for making modifications,
|
|
||||||
including but not limited to software source code, documentation
|
|
||||||
source, and configuration files.
|
|
||||||
|
|
||||||
"Object" form shall mean any form resulting from mechanical
|
|
||||||
transformation or translation of a Source form, including but
|
|
||||||
not limited to compiled object code, generated documentation,
|
|
||||||
and conversions to other media types.
|
|
||||||
|
|
||||||
"Work" shall mean the work of authorship, whether in Source or
|
|
||||||
Object form, made available under the License, as indicated by a
|
|
||||||
copyright notice that is included in or attached to the work
|
|
||||||
(an example is provided in the Appendix below).
|
|
||||||
|
|
||||||
"Derivative Works" shall mean any work, whether in Source or Object
|
|
||||||
form, that is based on (or derived from) the Work and for which the
|
|
||||||
editorial revisions, annotations, elaborations, or other modifications
|
|
||||||
represent, as a whole, an original work of authorship. For the purposes
|
|
||||||
of this License, Derivative Works shall not include works that remain
|
|
||||||
separable from, or merely link (or bind by name) to the interfaces of,
|
|
||||||
the Work and Derivative Works thereof.
|
|
||||||
|
|
||||||
"Contribution" shall mean any work of authorship, including
|
|
||||||
the original version of the Work and any modifications or additions
|
|
||||||
to that Work or Derivative Works thereof, that is intentionally
|
|
||||||
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
||||||
or by an individual or Legal Entity authorized to submit on behalf of
|
|
||||||
the copyright owner. For the purposes of this definition, "submitted"
|
|
||||||
means any form of electronic, verbal, or written communication sent
|
|
||||||
to the Licensor or its representatives, including but not limited to
|
|
||||||
communication on electronic mailing lists, source code control systems,
|
|
||||||
and issue tracking systems that are managed by, or on behalf of, the
|
|
||||||
Licensor for the purpose of discussing and improving the Work, but
|
|
||||||
excluding communication that is conspicuously marked or otherwise
|
|
||||||
designated in writing by the copyright owner as "Not a Contribution."
|
|
||||||
|
|
||||||
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
||||||
on behalf of whom a Contribution has been received by Licensor and
|
|
||||||
subsequently incorporated within the Work.
|
|
||||||
|
|
||||||
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
copyright license to reproduce, prepare Derivative Works of,
|
|
||||||
publicly display, publicly perform, sublicense, and distribute the
|
|
||||||
Work and such Derivative Works in Source or Object form.
|
|
||||||
|
|
||||||
3. Grant of Patent License. Subject to the terms and conditions of
|
|
||||||
this License, each Contributor hereby grants to You a perpetual,
|
|
||||||
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
||||||
(except as stated in this section) patent license to make, have made,
|
|
||||||
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
||||||
where such license applies only to those patent claims licensable
|
|
||||||
by such Contributor that are necessarily infringed by their
|
|
||||||
Contribution(s) alone or by combination of their Contribution(s)
|
|
||||||
with the Work to which such Contribution(s) was submitted. If You
|
|
||||||
institute patent litigation against any entity (including a
|
|
||||||
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
||||||
or a Contribution incorporated within the Work constitutes direct
|
|
||||||
or contributory patent infringement, then any patent licenses
|
|
||||||
granted to You under this License for that Work shall terminate
|
|
||||||
as of the date such litigation is filed.
|
|
||||||
|
|
||||||
4. Redistribution. You may reproduce and distribute copies of the
|
|
||||||
Work or Derivative Works thereof in any medium, with or without
|
|
||||||
modifications, and in Source or Object form, provided that You
|
|
||||||
meet the following conditions:
|
|
||||||
|
|
||||||
(a) You must give any other recipients of the Work or
|
|
||||||
Derivative Works a copy of this License; and
|
|
||||||
|
|
||||||
(b) You must cause any modified files to carry prominent notices
|
|
||||||
stating that You changed the files; and
|
|
||||||
|
|
||||||
(c) You must retain, in the Source form of any Derivative Works
|
|
||||||
that You distribute, all copyright, patent, trademark, and
|
|
||||||
attribution notices from the Source form of the Work,
|
|
||||||
excluding those notices that do not pertain to any part of
|
|
||||||
the Derivative Works; and
|
|
||||||
|
|
||||||
(d) If the Work includes a "NOTICE" text file as part of its
|
|
||||||
distribution, then any Derivative Works that You distribute must
|
|
||||||
include a readable copy of the attribution notices contained
|
|
||||||
within such NOTICE file, excluding those notices that do not
|
|
||||||
pertain to any part of the Derivative Works, in at least one
|
|
||||||
of the following places: within a NOTICE text file distributed
|
|
||||||
as part of the Derivative Works; within the Source form or
|
|
||||||
documentation, if provided along with the Derivative Works; or,
|
|
||||||
within a display generated by the Derivative Works, if and
|
|
||||||
wherever such third-party notices normally appear. The contents
|
|
||||||
of the NOTICE file are for informational purposes only and
|
|
||||||
do not modify the License. You may add Your own attribution
|
|
||||||
notices within Derivative Works that You distribute, alongside
|
|
||||||
or as an addendum to the NOTICE text from the Work, provided
|
|
||||||
that such additional attribution notices cannot be construed
|
|
||||||
as modifying the License.
|
|
||||||
|
|
||||||
You may add Your own copyright statement to Your modifications and
|
|
||||||
may provide additional or different license terms and conditions
|
|
||||||
for use, reproduction, or distribution of Your modifications, or
|
|
||||||
for any such Derivative Works as a whole, provided Your use,
|
|
||||||
reproduction, and distribution of the Work otherwise complies with
|
|
||||||
the conditions stated in this License.
|
|
||||||
|
|
||||||
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
||||||
any Contribution intentionally submitted for inclusion in the Work
|
|
||||||
by You to the Licensor shall be under the terms and conditions of
|
|
||||||
this License, without any additional terms or conditions.
|
|
||||||
Notwithstanding the above, nothing herein shall supersede or modify
|
|
||||||
the terms of any separate license agreement you may have executed
|
|
||||||
with Licensor regarding such Contributions.
|
|
||||||
|
|
||||||
6. Trademarks. This License does not grant permission to use the trade
|
|
||||||
names, trademarks, service marks, or product names of the Licensor,
|
|
||||||
except as required for reasonable and customary use in describing the
|
|
||||||
origin of the Work and reproducing the content of the NOTICE file.
|
|
||||||
|
|
||||||
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
||||||
agreed to in writing, Licensor provides the Work (and each
|
|
||||||
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
||||||
implied, including, without limitation, any warranties or conditions
|
|
||||||
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
||||||
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
||||||
appropriateness of using or redistributing the Work and assume any
|
|
||||||
risks associated with Your exercise of permissions under this License.
|
|
||||||
|
|
||||||
8. Limitation of Liability. In no event and under no legal theory,
|
|
||||||
whether in tort (including negligence), contract, or otherwise,
|
|
||||||
unless required by applicable law (such as deliberate and grossly
|
|
||||||
negligent acts) or agreed to in writing, shall any Contributor be
|
|
||||||
liable to You for damages, including any direct, indirect, special,
|
|
||||||
incidental, or consequential damages of any character arising as a
|
|
||||||
result of this License or out of the use or inability to use the
|
|
||||||
Work (including but not limited to damages for loss of goodwill,
|
|
||||||
work stoppage, computer failure or malfunction, or any and all
|
|
||||||
other commercial damages or losses), even if such Contributor
|
|
||||||
has been advised of the possibility of such damages.
|
|
||||||
|
|
||||||
9. Accepting Warranty or Additional Liability. While redistributing
|
|
||||||
the Work or Derivative Works thereof, You may choose to offer,
|
|
||||||
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
||||||
or other liability obligations and/or rights consistent with this
|
|
||||||
License. However, in accepting such obligations, You may act only
|
|
||||||
on Your own behalf and on Your sole responsibility, not on behalf
|
|
||||||
of any other Contributor, and only if You agree to indemnify,
|
|
||||||
defend, and hold each Contributor harmless for any liability
|
|
||||||
incurred by, or claims asserted against, such Contributor by reason
|
|
||||||
of your accepting any such warranty or additional liability.
|
|
||||||
|
|
||||||
END OF TERMS AND CONDITIONS
|
|
||||||
|
|
||||||
APPENDIX: How to apply the Apache License to your work.
|
|
||||||
|
|
||||||
To apply the Apache License to your work, attach the following
|
|
||||||
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
||||||
replaced with your own identifying information. (Don't include
|
|
||||||
the brackets!) The text should be enclosed in the appropriate
|
|
||||||
comment syntax for the file format. We also recommend that a
|
|
||||||
file or class name and description of purpose be included on the
|
|
||||||
same "printed page" as the copyright notice for easier
|
|
||||||
identification within third-party archives.
|
|
||||||
|
|
||||||
Copyright [yyyy] [name of copyright owner]
|
|
||||||
|
|
||||||
Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
you may not use this file except in compliance with the License.
|
|
||||||
You may obtain a copy of the License at
|
|
||||||
|
|
||||||
http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
|
|
||||||
Unless required by applicable law or agreed to in writing, software
|
|
||||||
distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
See the License for the specific language governing permissions and
|
|
||||||
limitations under the License.
|
|
||||||
@ -1,2 +0,0 @@
|
|||||||
PR.registerLangHandler(PR.createSimpleLexer([["pln",/^[\t\n\f\r ]+/,null," \t\r\n"]],[["str",/^"(?:[^\n\f\r"\\]|\\(?:\r\n?|\n|\f)|\\[\S\s])*"/,null],["str",/^'(?:[^\n\f\r'\\]|\\(?:\r\n?|\n|\f)|\\[\S\s])*'/,null],["lang-css-str",/^url\(([^"')]*)\)/i],["kwd",/^(?:url|rgb|!important|@import|@page|@media|@charset|inherit)(?=[^\w-]|$)/i,null],["lang-css-kw",/^(-?(?:[_a-z]|\\[\da-f]+ ?)(?:[\w-]|\\\\[\da-f]+ ?)*)\s*:/i],["com",/^\/\*[^*]*\*+(?:[^*/][^*]*\*+)*\//],["com",
|
|
||||||
/^(?:<\!--|--\>)/],["lit",/^(?:\d+|\d*\.\d+)(?:%|[a-z]+)?/i],["lit",/^#[\da-f]{3,6}/i],["pln",/^-?(?:[_a-z]|\\[\da-f]+ ?)(?:[\w-]|\\\\[\da-f]+ ?)*/i],["pun",/^[^\s\w"']+/]]),["css"]);PR.registerLangHandler(PR.createSimpleLexer([],[["kwd",/^-?(?:[_a-z]|\\[\da-f]+ ?)(?:[\w-]|\\\\[\da-f]+ ?)*/i]]),["css-kw"]);PR.registerLangHandler(PR.createSimpleLexer([],[["str",/^[^"')]+/]]),["css-str"]);
|
|
||||||
@ -1,28 +0,0 @@
|
|||||||
var q=null;window.PR_SHOULD_USE_CONTINUATION=!0;
|
|
||||||
(function(){function L(a){function m(a){var f=a.charCodeAt(0);if(f!==92)return f;var b=a.charAt(1);return(f=r[b])?f:"0"<=b&&b<="7"?parseInt(a.substring(1),8):b==="u"||b==="x"?parseInt(a.substring(2),16):a.charCodeAt(1)}function e(a){if(a<32)return(a<16?"\\x0":"\\x")+a.toString(16);a=String.fromCharCode(a);if(a==="\\"||a==="-"||a==="["||a==="]")a="\\"+a;return a}function h(a){for(var f=a.substring(1,a.length-1).match(/\\u[\dA-Fa-f]{4}|\\x[\dA-Fa-f]{2}|\\[0-3][0-7]{0,2}|\\[0-7]{1,2}|\\[\S\s]|[^\\]/g),a=
|
|
||||||
[],b=[],o=f[0]==="^",c=o?1:0,i=f.length;c<i;++c){var j=f[c];if(/\\[bdsw]/i.test(j))a.push(j);else{var j=m(j),d;c+2<i&&"-"===f[c+1]?(d=m(f[c+2]),c+=2):d=j;b.push([j,d]);d<65||j>122||(d<65||j>90||b.push([Math.max(65,j)|32,Math.min(d,90)|32]),d<97||j>122||b.push([Math.max(97,j)&-33,Math.min(d,122)&-33]))}}b.sort(function(a,f){return a[0]-f[0]||f[1]-a[1]});f=[];j=[NaN,NaN];for(c=0;c<b.length;++c)i=b[c],i[0]<=j[1]+1?j[1]=Math.max(j[1],i[1]):f.push(j=i);b=["["];o&&b.push("^");b.push.apply(b,a);for(c=0;c<
|
|
||||||
f.length;++c)i=f[c],b.push(e(i[0])),i[1]>i[0]&&(i[1]+1>i[0]&&b.push("-"),b.push(e(i[1])));b.push("]");return b.join("")}function y(a){for(var f=a.source.match(/\[(?:[^\\\]]|\\[\S\s])*]|\\u[\dA-Fa-f]{4}|\\x[\dA-Fa-f]{2}|\\\d+|\\[^\dux]|\(\?[!:=]|[()^]|[^()[\\^]+/g),b=f.length,d=[],c=0,i=0;c<b;++c){var j=f[c];j==="("?++i:"\\"===j.charAt(0)&&(j=+j.substring(1))&&j<=i&&(d[j]=-1)}for(c=1;c<d.length;++c)-1===d[c]&&(d[c]=++t);for(i=c=0;c<b;++c)j=f[c],j==="("?(++i,d[i]===void 0&&(f[c]="(?:")):"\\"===j.charAt(0)&&
|
|
||||||
(j=+j.substring(1))&&j<=i&&(f[c]="\\"+d[i]);for(i=c=0;c<b;++c)"^"===f[c]&&"^"!==f[c+1]&&(f[c]="");if(a.ignoreCase&&s)for(c=0;c<b;++c)j=f[c],a=j.charAt(0),j.length>=2&&a==="["?f[c]=h(j):a!=="\\"&&(f[c]=j.replace(/[A-Za-z]/g,function(a){a=a.charCodeAt(0);return"["+String.fromCharCode(a&-33,a|32)+"]"}));return f.join("")}for(var t=0,s=!1,l=!1,p=0,d=a.length;p<d;++p){var g=a[p];if(g.ignoreCase)l=!0;else if(/[a-z]/i.test(g.source.replace(/\\u[\da-f]{4}|\\x[\da-f]{2}|\\[^UXux]/gi,""))){s=!0;l=!1;break}}for(var r=
|
|
||||||
{b:8,t:9,n:10,v:11,f:12,r:13},n=[],p=0,d=a.length;p<d;++p){g=a[p];if(g.global||g.multiline)throw Error(""+g);n.push("(?:"+y(g)+")")}return RegExp(n.join("|"),l?"gi":"g")}function M(a){function m(a){switch(a.nodeType){case 1:if(e.test(a.className))break;for(var g=a.firstChild;g;g=g.nextSibling)m(g);g=a.nodeName;if("BR"===g||"LI"===g)h[s]="\n",t[s<<1]=y++,t[s++<<1|1]=a;break;case 3:case 4:g=a.nodeValue,g.length&&(g=p?g.replace(/\r\n?/g,"\n"):g.replace(/[\t\n\r ]+/g," "),h[s]=g,t[s<<1]=y,y+=g.length,
|
|
||||||
t[s++<<1|1]=a)}}var e=/(?:^|\s)nocode(?:\s|$)/,h=[],y=0,t=[],s=0,l;a.currentStyle?l=a.currentStyle.whiteSpace:window.getComputedStyle&&(l=document.defaultView.getComputedStyle(a,q).getPropertyValue("white-space"));var p=l&&"pre"===l.substring(0,3);m(a);return{a:h.join("").replace(/\n$/,""),c:t}}function B(a,m,e,h){m&&(a={a:m,d:a},e(a),h.push.apply(h,a.e))}function x(a,m){function e(a){for(var l=a.d,p=[l,"pln"],d=0,g=a.a.match(y)||[],r={},n=0,z=g.length;n<z;++n){var f=g[n],b=r[f],o=void 0,c;if(typeof b===
|
|
||||||
"string")c=!1;else{var i=h[f.charAt(0)];if(i)o=f.match(i[1]),b=i[0];else{for(c=0;c<t;++c)if(i=m[c],o=f.match(i[1])){b=i[0];break}o||(b="pln")}if((c=b.length>=5&&"lang-"===b.substring(0,5))&&!(o&&typeof o[1]==="string"))c=!1,b="src";c||(r[f]=b)}i=d;d+=f.length;if(c){c=o[1];var j=f.indexOf(c),k=j+c.length;o[2]&&(k=f.length-o[2].length,j=k-c.length);b=b.substring(5);B(l+i,f.substring(0,j),e,p);B(l+i+j,c,C(b,c),p);B(l+i+k,f.substring(k),e,p)}else p.push(l+i,b)}a.e=p}var h={},y;(function(){for(var e=a.concat(m),
|
|
||||||
l=[],p={},d=0,g=e.length;d<g;++d){var r=e[d],n=r[3];if(n)for(var k=n.length;--k>=0;)h[n.charAt(k)]=r;r=r[1];n=""+r;p.hasOwnProperty(n)||(l.push(r),p[n]=q)}l.push(/[\S\s]/);y=L(l)})();var t=m.length;return e}function u(a){var m=[],e=[];a.tripleQuotedStrings?m.push(["str",/^(?:'''(?:[^'\\]|\\[\S\s]|''?(?=[^']))*(?:'''|$)|"""(?:[^"\\]|\\[\S\s]|""?(?=[^"]))*(?:"""|$)|'(?:[^'\\]|\\[\S\s])*(?:'|$)|"(?:[^"\\]|\\[\S\s])*(?:"|$))/,q,"'\""]):a.multiLineStrings?m.push(["str",/^(?:'(?:[^'\\]|\\[\S\s])*(?:'|$)|"(?:[^"\\]|\\[\S\s])*(?:"|$)|`(?:[^\\`]|\\[\S\s])*(?:`|$))/,
|
|
||||||
q,"'\"`"]):m.push(["str",/^(?:'(?:[^\n\r'\\]|\\.)*(?:'|$)|"(?:[^\n\r"\\]|\\.)*(?:"|$))/,q,"\"'"]);a.verbatimStrings&&e.push(["str",/^@"(?:[^"]|"")*(?:"|$)/,q]);var h=a.hashComments;h&&(a.cStyleComments?(h>1?m.push(["com",/^#(?:##(?:[^#]|#(?!##))*(?:###|$)|.*)/,q,"#"]):m.push(["com",/^#(?:(?:define|elif|else|endif|error|ifdef|include|ifndef|line|pragma|undef|warning)\b|[^\n\r]*)/,q,"#"]),e.push(["str",/^<(?:(?:(?:\.\.\/)*|\/?)(?:[\w-]+(?:\/[\w-]+)+)?[\w-]+\.h|[a-z]\w*)>/,q])):m.push(["com",/^#[^\n\r]*/,
|
|
||||||
q,"#"]));a.cStyleComments&&(e.push(["com",/^\/\/[^\n\r]*/,q]),e.push(["com",/^\/\*[\S\s]*?(?:\*\/|$)/,q]));a.regexLiterals&&e.push(["lang-regex",/^(?:^^\.?|[!+-]|!=|!==|#|%|%=|&|&&|&&=|&=|\(|\*|\*=|\+=|,|-=|->|\/|\/=|:|::|;|<|<<|<<=|<=|=|==|===|>|>=|>>|>>=|>>>|>>>=|[?@[^]|\^=|\^\^|\^\^=|{|\||\|=|\|\||\|\|=|~|break|case|continue|delete|do|else|finally|instanceof|return|throw|try|typeof)\s*(\/(?=[^*/])(?:[^/[\\]|\\[\S\s]|\[(?:[^\\\]]|\\[\S\s])*(?:]|$))+\/)/]);(h=a.types)&&e.push(["typ",h]);a=(""+a.keywords).replace(/^ | $/g,
|
|
||||||
"");a.length&&e.push(["kwd",RegExp("^(?:"+a.replace(/[\s,]+/g,"|")+")\\b"),q]);m.push(["pln",/^\s+/,q," \r\n\t\xa0"]);e.push(["lit",/^@[$_a-z][\w$@]*/i,q],["typ",/^(?:[@_]?[A-Z]+[a-z][\w$@]*|\w+_t\b)/,q],["pln",/^[$_a-z][\w$@]*/i,q],["lit",/^(?:0x[\da-f]+|(?:\d(?:_\d+)*\d*(?:\.\d*)?|\.\d\+)(?:e[+-]?\d+)?)[a-z]*/i,q,"0123456789"],["pln",/^\\[\S\s]?/,q],["pun",/^.[^\s\w"-$'./@\\`]*/,q]);return x(m,e)}function D(a,m){function e(a){switch(a.nodeType){case 1:if(k.test(a.className))break;if("BR"===a.nodeName)h(a),
|
|
||||||
a.parentNode&&a.parentNode.removeChild(a);else for(a=a.firstChild;a;a=a.nextSibling)e(a);break;case 3:case 4:if(p){var b=a.nodeValue,d=b.match(t);if(d){var c=b.substring(0,d.index);a.nodeValue=c;(b=b.substring(d.index+d[0].length))&&a.parentNode.insertBefore(s.createTextNode(b),a.nextSibling);h(a);c||a.parentNode.removeChild(a)}}}}function h(a){function b(a,d){var e=d?a.cloneNode(!1):a,f=a.parentNode;if(f){var f=b(f,1),g=a.nextSibling;f.appendChild(e);for(var h=g;h;h=g)g=h.nextSibling,f.appendChild(h)}return e}
|
|
||||||
for(;!a.nextSibling;)if(a=a.parentNode,!a)return;for(var a=b(a.nextSibling,0),e;(e=a.parentNode)&&e.nodeType===1;)a=e;d.push(a)}var k=/(?:^|\s)nocode(?:\s|$)/,t=/\r\n?|\n/,s=a.ownerDocument,l;a.currentStyle?l=a.currentStyle.whiteSpace:window.getComputedStyle&&(l=s.defaultView.getComputedStyle(a,q).getPropertyValue("white-space"));var p=l&&"pre"===l.substring(0,3);for(l=s.createElement("LI");a.firstChild;)l.appendChild(a.firstChild);for(var d=[l],g=0;g<d.length;++g)e(d[g]);m===(m|0)&&d[0].setAttribute("value",
|
|
||||||
m);var r=s.createElement("OL");r.className="linenums";for(var n=Math.max(0,m-1|0)||0,g=0,z=d.length;g<z;++g)l=d[g],l.className="L"+(g+n)%10,l.firstChild||l.appendChild(s.createTextNode("\xa0")),r.appendChild(l);a.appendChild(r)}function k(a,m){for(var e=m.length;--e>=0;){var h=m[e];A.hasOwnProperty(h)?window.console&&console.warn("cannot override language handler %s",h):A[h]=a}}function C(a,m){if(!a||!A.hasOwnProperty(a))a=/^\s*</.test(m)?"default-markup":"default-code";return A[a]}function E(a){var m=
|
|
||||||
a.g;try{var e=M(a.h),h=e.a;a.a=h;a.c=e.c;a.d=0;C(m,h)(a);var k=/\bMSIE\b/.test(navigator.userAgent),m=/\n/g,t=a.a,s=t.length,e=0,l=a.c,p=l.length,h=0,d=a.e,g=d.length,a=0;d[g]=s;var r,n;for(n=r=0;n<g;)d[n]!==d[n+2]?(d[r++]=d[n++],d[r++]=d[n++]):n+=2;g=r;for(n=r=0;n<g;){for(var z=d[n],f=d[n+1],b=n+2;b+2<=g&&d[b+1]===f;)b+=2;d[r++]=z;d[r++]=f;n=b}for(d.length=r;h<p;){var o=l[h+2]||s,c=d[a+2]||s,b=Math.min(o,c),i=l[h+1],j;if(i.nodeType!==1&&(j=t.substring(e,b))){k&&(j=j.replace(m,"\r"));i.nodeValue=
|
|
||||||
j;var u=i.ownerDocument,v=u.createElement("SPAN");v.className=d[a+1];var x=i.parentNode;x.replaceChild(v,i);v.appendChild(i);e<o&&(l[h+1]=i=u.createTextNode(t.substring(b,o)),x.insertBefore(i,v.nextSibling))}e=b;e>=o&&(h+=2);e>=c&&(a+=2)}}catch(w){"console"in window&&console.log(w&&w.stack?w.stack:w)}}var v=["break,continue,do,else,for,if,return,while"],w=[[v,"auto,case,char,const,default,double,enum,extern,float,goto,int,long,register,short,signed,sizeof,static,struct,switch,typedef,union,unsigned,void,volatile"],
|
|
||||||
"catch,class,delete,false,import,new,operator,private,protected,public,this,throw,true,try,typeof"],F=[w,"alignof,align_union,asm,axiom,bool,concept,concept_map,const_cast,constexpr,decltype,dynamic_cast,explicit,export,friend,inline,late_check,mutable,namespace,nullptr,reinterpret_cast,static_assert,static_cast,template,typeid,typename,using,virtual,where"],G=[w,"abstract,boolean,byte,extends,final,finally,implements,import,instanceof,null,native,package,strictfp,super,synchronized,throws,transient"],
|
|
||||||
H=[G,"as,base,by,checked,decimal,delegate,descending,dynamic,event,fixed,foreach,from,group,implicit,in,interface,internal,into,is,lock,object,out,override,orderby,params,partial,readonly,ref,sbyte,sealed,stackalloc,string,select,uint,ulong,unchecked,unsafe,ushort,var"],w=[w,"debugger,eval,export,function,get,null,set,undefined,var,with,Infinity,NaN"],I=[v,"and,as,assert,class,def,del,elif,except,exec,finally,from,global,import,in,is,lambda,nonlocal,not,or,pass,print,raise,try,with,yield,False,True,None"],
|
|
||||||
J=[v,"alias,and,begin,case,class,def,defined,elsif,end,ensure,false,in,module,next,nil,not,or,redo,rescue,retry,self,super,then,true,undef,unless,until,when,yield,BEGIN,END"],v=[v,"case,done,elif,esac,eval,fi,function,in,local,set,then,until"],K=/^(DIR|FILE|vector|(de|priority_)?queue|list|stack|(const_)?iterator|(multi)?(set|map)|bitset|u?(int|float)\d*)/,N=/\S/,O=u({keywords:[F,H,w,"caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END"+
|
|
||||||
I,J,v],hashComments:!0,cStyleComments:!0,multiLineStrings:!0,regexLiterals:!0}),A={};k(O,["default-code"]);k(x([],[["pln",/^[^<?]+/],["dec",/^<!\w[^>]*(?:>|$)/],["com",/^<\!--[\S\s]*?(?:--\>|$)/],["lang-",/^<\?([\S\s]+?)(?:\?>|$)/],["lang-",/^<%([\S\s]+?)(?:%>|$)/],["pun",/^(?:<[%?]|[%?]>)/],["lang-",/^<xmp\b[^>]*>([\S\s]+?)<\/xmp\b[^>]*>/i],["lang-js",/^<script\b[^>]*>([\S\s]*?)(<\/script\b[^>]*>)/i],["lang-css",/^<style\b[^>]*>([\S\s]*?)(<\/style\b[^>]*>)/i],["lang-in.tag",/^(<\/?[a-z][^<>]*>)/i]]),
|
|
||||||
["default-markup","htm","html","mxml","xhtml","xml","xsl"]);k(x([["pln",/^\s+/,q," \t\r\n"],["atv",/^(?:"[^"]*"?|'[^']*'?)/,q,"\"'"]],[["tag",/^^<\/?[a-z](?:[\w-.:]*\w)?|\/?>$/i],["atn",/^(?!style[\s=]|on)[a-z](?:[\w:-]*\w)?/i],["lang-uq.val",/^=\s*([^\s"'>]*(?:[^\s"'/>]|\/(?=\s)))/],["pun",/^[/<->]+/],["lang-js",/^on\w+\s*=\s*"([^"]+)"/i],["lang-js",/^on\w+\s*=\s*'([^']+)'/i],["lang-js",/^on\w+\s*=\s*([^\s"'>]+)/i],["lang-css",/^style\s*=\s*"([^"]+)"/i],["lang-css",/^style\s*=\s*'([^']+)'/i],["lang-css",
|
|
||||||
/^style\s*=\s*([^\s"'>]+)/i]]),["in.tag"]);k(x([],[["atv",/^[\S\s]+/]]),["uq.val"]);k(u({keywords:F,hashComments:!0,cStyleComments:!0,types:K}),["c","cc","cpp","cxx","cyc","m"]);k(u({keywords:"null,true,false"}),["json"]);k(u({keywords:H,hashComments:!0,cStyleComments:!0,verbatimStrings:!0,types:K}),["cs"]);k(u({keywords:G,cStyleComments:!0}),["java"]);k(u({keywords:v,hashComments:!0,multiLineStrings:!0}),["bsh","csh","sh"]);k(u({keywords:I,hashComments:!0,multiLineStrings:!0,tripleQuotedStrings:!0}),
|
|
||||||
["cv","py"]);k(u({keywords:"caller,delete,die,do,dump,elsif,eval,exit,foreach,for,goto,if,import,last,local,my,next,no,our,print,package,redo,require,sub,undef,unless,until,use,wantarray,while,BEGIN,END",hashComments:!0,multiLineStrings:!0,regexLiterals:!0}),["perl","pl","pm"]);k(u({keywords:J,hashComments:!0,multiLineStrings:!0,regexLiterals:!0}),["rb"]);k(u({keywords:w,cStyleComments:!0,regexLiterals:!0}),["js"]);k(u({keywords:"all,and,by,catch,class,else,extends,false,finally,for,if,in,is,isnt,loop,new,no,not,null,of,off,on,or,return,super,then,true,try,unless,until,when,while,yes",
|
|
||||||
hashComments:3,cStyleComments:!0,multilineStrings:!0,tripleQuotedStrings:!0,regexLiterals:!0}),["coffee"]);k(x([],[["str",/^[\S\s]+/]]),["regex"]);window.prettyPrintOne=function(a,m,e){var h=document.createElement("PRE");h.innerHTML=a;e&&D(h,e);E({g:m,i:e,h:h});return h.innerHTML};window.prettyPrint=function(a){function m(){for(var e=window.PR_SHOULD_USE_CONTINUATION?l.now()+250:Infinity;p<h.length&&l.now()<e;p++){var n=h[p],k=n.className;if(k.indexOf("prettyprint")>=0){var k=k.match(g),f,b;if(b=
|
|
||||||
!k){b=n;for(var o=void 0,c=b.firstChild;c;c=c.nextSibling)var i=c.nodeType,o=i===1?o?b:c:i===3?N.test(c.nodeValue)?b:o:o;b=(f=o===b?void 0:o)&&"CODE"===f.tagName}b&&(k=f.className.match(g));k&&(k=k[1]);b=!1;for(o=n.parentNode;o;o=o.parentNode)if((o.tagName==="pre"||o.tagName==="code"||o.tagName==="xmp")&&o.className&&o.className.indexOf("prettyprint")>=0){b=!0;break}b||((b=(b=n.className.match(/\blinenums\b(?::(\d+))?/))?b[1]&&b[1].length?+b[1]:!0:!1)&&D(n,b),d={g:k,h:n,i:b},E(d))}}p<h.length?setTimeout(m,
|
|
||||||
250):a&&a()}for(var e=[document.getElementsByTagName("pre"),document.getElementsByTagName("code"),document.getElementsByTagName("xmp")],h=[],k=0;k<e.length;++k)for(var t=0,s=e[k].length;t<s;++t)h.push(e[k][t]);var e=q,l=Date;l.now||(l={now:function(){return+new Date}});var p=0,d,g=/\blang(?:uage)?-([\w.]+)(?!\S)/;m()};window.PR={createSimpleLexer:x,registerLangHandler:k,sourceDecorator:u,PR_ATTRIB_NAME:"atn",PR_ATTRIB_VALUE:"atv",PR_COMMENT:"com",PR_DECLARATION:"dec",PR_KEYWORD:"kwd",PR_LITERAL:"lit",
|
|
||||||
PR_NOCODE:"nocode",PR_PLAIN:"pln",PR_PUNCTUATION:"pun",PR_SOURCE:"src",PR_STRING:"str",PR_TAG:"tag",PR_TYPE:"typ"}})();
|
|
||||||
@ -1,83 +0,0 @@
|
|||||||
|
|
||||||
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";
|
|
||||||
}
|
|
||||||
});
|
|
||||||
}
|
|
||||||
});
|
|
||||||
@ -1,671 +0,0 @@
|
|||||||
@import url(https://fonts.googleapis.com/css?family=Montserrat:400,700);
|
|
||||||
|
|
||||||
* {
|
|
||||||
box-sizing: border-box
|
|
||||||
}
|
|
||||||
|
|
||||||
html, body {
|
|
||||||
height: 100%;
|
|
||||||
width: 100%;
|
|
||||||
}
|
|
||||||
|
|
||||||
body {
|
|
||||||
color: #4d4e53;
|
|
||||||
background-color: white;
|
|
||||||
margin: 0 auto;
|
|
||||||
padding: 0 20px;
|
|
||||||
font-family: 'Helvetica Neue', Helvetica, sans-serif;
|
|
||||||
font-size: 16px;
|
|
||||||
}
|
|
||||||
|
|
||||||
img {
|
|
||||||
max-width: 100%;
|
|
||||||
}
|
|
||||||
|
|
||||||
a,
|
|
||||||
a:active {
|
|
||||||
color: #606;
|
|
||||||
text-decoration: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
a:hover {
|
|
||||||
text-decoration: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
article a {
|
|
||||||
border-bottom: 1px solid #ddd;
|
|
||||||
}
|
|
||||||
|
|
||||||
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 {
|
|
||||||
font-family: 'Montserrat', sans-serif;
|
|
||||||
}
|
|
||||||
|
|
||||||
h1, h2, h3, h4, h5, h6 {
|
|
||||||
color: #000;
|
|
||||||
font-weight: 400;
|
|
||||||
margin: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
h1 {
|
|
||||||
font-weight: 300;
|
|
||||||
font-size: 48px;
|
|
||||||
margin: 1em 0 .5em;
|
|
||||||
}
|
|
||||||
|
|
||||||
h1.page-title {
|
|
||||||
font-size: 48px;
|
|
||||||
margin: 1em 30px;
|
|
||||||
line-height: 100%;
|
|
||||||
word-wrap: break-word;
|
|
||||||
}
|
|
||||||
|
|
||||||
h2 {
|
|
||||||
font-size: 24px;
|
|
||||||
margin: 1.5em 0 .3em;
|
|
||||||
}
|
|
||||||
|
|
||||||
h3 {
|
|
||||||
font-size: 24px;
|
|
||||||
margin: 1.2em 0 .3em;
|
|
||||||
}
|
|
||||||
|
|
||||||
h4 {
|
|
||||||
font-size: 18px;
|
|
||||||
margin: 1em 0 .2em;
|
|
||||||
color: #4d4e53;
|
|
||||||
}
|
|
||||||
|
|
||||||
h4.name {
|
|
||||||
color: #fff;
|
|
||||||
background: #6d426d;
|
|
||||||
box-shadow: 0 .25em .5em #d3d3d3;
|
|
||||||
border-top: 1px solid #d3d3d3;
|
|
||||||
border-bottom: 1px solid #d3d3d3;
|
|
||||||
margin: 1.5em 0 0.5em;
|
|
||||||
padding: .75em 0 .75em 10px;
|
|
||||||
}
|
|
||||||
|
|
||||||
h4.name a {
|
|
||||||
color: #fc83ff;
|
|
||||||
}
|
|
||||||
|
|
||||||
h4.name a:hover {
|
|
||||||
border-bottom-color: #fc83ff;
|
|
||||||
}
|
|
||||||
|
|
||||||
h5, .container-overview .subsection-title {
|
|
||||||
font-size: 120%;
|
|
||||||
letter-spacing: -0.01em;
|
|
||||||
margin: 8px 0 3px 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
h6 {
|
|
||||||
font-size: 100%;
|
|
||||||
letter-spacing: -0.01em;
|
|
||||||
margin: 6px 0 3px 0;
|
|
||||||
font-style: italic;
|
|
||||||
}
|
|
||||||
|
|
||||||
tt, code, kbd, samp {
|
|
||||||
font-family: Consolas, Monaco, 'Andale Mono', monospace;
|
|
||||||
background: #f4f4f4;
|
|
||||||
padding: 1px 5px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.class-description {
|
|
||||||
font-size: 130%;
|
|
||||||
line-height: 140%;
|
|
||||||
margin-bottom: 1em;
|
|
||||||
margin-top: 1em;
|
|
||||||
}
|
|
||||||
|
|
||||||
.class-description:empty {
|
|
||||||
margin: 0
|
|
||||||
}
|
|
||||||
|
|
||||||
#main {
|
|
||||||
float: right;
|
|
||||||
min-width: 360px;
|
|
||||||
width: calc(100% - 240px);
|
|
||||||
}
|
|
||||||
|
|
||||||
header {
|
|
||||||
display: block
|
|
||||||
}
|
|
||||||
|
|
||||||
section {
|
|
||||||
display: block;
|
|
||||||
background-color: #fff;
|
|
||||||
padding: 0 0 0 30px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.variation {
|
|
||||||
display: none
|
|
||||||
}
|
|
||||||
|
|
||||||
.signature-attributes {
|
|
||||||
font-size: 60%;
|
|
||||||
color: #eee;
|
|
||||||
font-style: italic;
|
|
||||||
font-weight: lighter;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav {
|
|
||||||
float: left;
|
|
||||||
display: block;
|
|
||||||
width: 250px;
|
|
||||||
background: #fff;
|
|
||||||
overflow: auto;
|
|
||||||
position: fixed;
|
|
||||||
height: 100%;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav #nav-search{
|
|
||||||
width: 210px;
|
|
||||||
height: 30px;
|
|
||||||
padding: 5px 10px;
|
|
||||||
font-size: 12px;
|
|
||||||
line-height: 1.5;
|
|
||||||
border-radius: 3px;
|
|
||||||
margin-right: 20px;
|
|
||||||
margin-top: 20px;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav.wrap a{
|
|
||||||
word-wrap: break-word;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav h3 {
|
|
||||||
margin-top: 12px;
|
|
||||||
font-size: 13px;
|
|
||||||
text-transform: uppercase;
|
|
||||||
letter-spacing: 1px;
|
|
||||||
font-weight: 700;
|
|
||||||
line-height: 24px;
|
|
||||||
margin: 15px 0 10px;
|
|
||||||
padding: 0;
|
|
||||||
color: #000;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav ul {
|
|
||||||
font-family: 'Lucida Grande', 'Lucida Sans Unicode', arial, sans-serif;
|
|
||||||
font-size: 100%;
|
|
||||||
line-height: 17px;
|
|
||||||
padding: 0;
|
|
||||||
margin: 0;
|
|
||||||
list-style-type: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav ul a,
|
|
||||||
nav ul a:active {
|
|
||||||
font-family: 'Montserrat', sans-serif;
|
|
||||||
line-height: 18px;
|
|
||||||
padding: 0;
|
|
||||||
display: block;
|
|
||||||
font-size: 12px;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav a:hover,
|
|
||||||
nav a:active {
|
|
||||||
color: #606;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav > ul {
|
|
||||||
padding: 0 10px;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav > ul > li > a {
|
|
||||||
color: #606;
|
|
||||||
margin-top: 10px;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav ul ul a {
|
|
||||||
color: hsl(207, 1%, 60%);
|
|
||||||
border-left: 1px solid hsl(207, 10%, 86%);
|
|
||||||
}
|
|
||||||
|
|
||||||
nav ul ul a,
|
|
||||||
nav ul ul a:active {
|
|
||||||
padding-left: 20px
|
|
||||||
}
|
|
||||||
|
|
||||||
nav h2 {
|
|
||||||
font-size: 13px;
|
|
||||||
margin: 10px 0 0 0;
|
|
||||||
padding: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav > h2 > a {
|
|
||||||
margin: 10px 0 -10px;
|
|
||||||
color: #606 !important;
|
|
||||||
}
|
|
||||||
|
|
||||||
footer {
|
|
||||||
color: hsl(0, 0%, 28%);
|
|
||||||
margin-left: 250px;
|
|
||||||
display: block;
|
|
||||||
padding: 15px;
|
|
||||||
font-style: italic;
|
|
||||||
font-size: 90%;
|
|
||||||
}
|
|
||||||
|
|
||||||
.ancestors {
|
|
||||||
color: #999
|
|
||||||
}
|
|
||||||
|
|
||||||
.ancestors a {
|
|
||||||
color: #999 !important;
|
|
||||||
}
|
|
||||||
|
|
||||||
.clear {
|
|
||||||
clear: both
|
|
||||||
}
|
|
||||||
|
|
||||||
.important {
|
|
||||||
font-weight: bold;
|
|
||||||
color: #950B02;
|
|
||||||
}
|
|
||||||
|
|
||||||
.yes-def {
|
|
||||||
text-indent: -1000px
|
|
||||||
}
|
|
||||||
|
|
||||||
.type-signature {
|
|
||||||
color: #CA79CA
|
|
||||||
}
|
|
||||||
|
|
||||||
.type-signature:last-child {
|
|
||||||
color: #eee;
|
|
||||||
}
|
|
||||||
|
|
||||||
.name, .signature {
|
|
||||||
font-family: Consolas, Monaco, 'Andale Mono', monospace
|
|
||||||
}
|
|
||||||
|
|
||||||
.signature {
|
|
||||||
color: #fc83ff;
|
|
||||||
}
|
|
||||||
|
|
||||||
.details {
|
|
||||||
margin-top: 6px;
|
|
||||||
border-left: 2px solid #DDD;
|
|
||||||
line-height: 20px;
|
|
||||||
font-size: 14px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.details dt {
|
|
||||||
width: auto;
|
|
||||||
float: left;
|
|
||||||
padding-left: 10px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.details dd {
|
|
||||||
margin-left: 70px;
|
|
||||||
margin-top: 6px;
|
|
||||||
margin-bottom: 6px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.details ul {
|
|
||||||
margin: 0
|
|
||||||
}
|
|
||||||
|
|
||||||
.details ul {
|
|
||||||
list-style-type: none
|
|
||||||
}
|
|
||||||
|
|
||||||
.details pre.prettyprint {
|
|
||||||
margin: 0
|
|
||||||
}
|
|
||||||
|
|
||||||
.details .object-value {
|
|
||||||
padding-top: 0
|
|
||||||
}
|
|
||||||
|
|
||||||
.description {
|
|
||||||
margin-bottom: 1em;
|
|
||||||
margin-top: 1em;
|
|
||||||
}
|
|
||||||
|
|
||||||
.code-caption {
|
|
||||||
font-style: italic;
|
|
||||||
font-size: 107%;
|
|
||||||
margin: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint {
|
|
||||||
font-size: 14px;
|
|
||||||
overflow: auto;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint.source {
|
|
||||||
width: inherit;
|
|
||||||
line-height: 18px;
|
|
||||||
display: block;
|
|
||||||
background-color: #0d152a;
|
|
||||||
color: #aeaeae;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint code {
|
|
||||||
line-height: 18px;
|
|
||||||
display: block;
|
|
||||||
background-color: #0d152a;
|
|
||||||
color: #4D4E53;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint > code {
|
|
||||||
padding: 15px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint .linenums code {
|
|
||||||
padding: 0 15px
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint .linenums li:first-of-type code {
|
|
||||||
padding-top: 15px
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint code span.line {
|
|
||||||
display: inline-block
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint.linenums {
|
|
||||||
padding-left: 70px;
|
|
||||||
-webkit-user-select: none;
|
|
||||||
-moz-user-select: none;
|
|
||||||
-ms-user-select: none;
|
|
||||||
user-select: none;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint.linenums ol {
|
|
||||||
padding-left: 0
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint.linenums li {
|
|
||||||
border-left: 3px #34446B solid;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint.linenums li.selected, .prettyprint.linenums li.selected * {
|
|
||||||
background-color: #34446B;
|
|
||||||
}
|
|
||||||
|
|
||||||
.prettyprint.linenums li * {
|
|
||||||
-webkit-user-select: text;
|
|
||||||
-moz-user-select: text;
|
|
||||||
-ms-user-select: text;
|
|
||||||
user-select: text;
|
|
||||||
}
|
|
||||||
|
|
||||||
table {
|
|
||||||
border-spacing: 0;
|
|
||||||
border: 1px solid #ddd;
|
|
||||||
border-collapse: collapse;
|
|
||||||
border-radius: 3px;
|
|
||||||
box-shadow: 0 1px 3px rgba(0,0,0,0.1);
|
|
||||||
width: 100%;
|
|
||||||
font-size: 14px;
|
|
||||||
margin: 1em 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
td, th {
|
|
||||||
margin: 0px;
|
|
||||||
text-align: left;
|
|
||||||
vertical-align: top;
|
|
||||||
padding: 10px;
|
|
||||||
display: table-cell;
|
|
||||||
}
|
|
||||||
|
|
||||||
thead tr, thead tr {
|
|
||||||
background-color: #fff;
|
|
||||||
font-weight: bold;
|
|
||||||
border-bottom: 1px solid #ddd;
|
|
||||||
}
|
|
||||||
|
|
||||||
.params .type {
|
|
||||||
white-space: nowrap;
|
|
||||||
}
|
|
||||||
|
|
||||||
.params code {
|
|
||||||
white-space: pre;
|
|
||||||
}
|
|
||||||
|
|
||||||
.params td, .params .name, .props .name, .name code {
|
|
||||||
color: #4D4E53;
|
|
||||||
font-family: Consolas, Monaco, 'Andale Mono', monospace;
|
|
||||||
font-size: 100%;
|
|
||||||
}
|
|
||||||
|
|
||||||
.params td {
|
|
||||||
border-top: 1px solid #eee
|
|
||||||
}
|
|
||||||
|
|
||||||
.params td.description > p:first-child, .props td.description > p:first-child {
|
|
||||||
margin-top: 0;
|
|
||||||
padding-top: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
.params td.description > p:last-child, .props td.description > p:last-child {
|
|
||||||
margin-bottom: 0;
|
|
||||||
padding-bottom: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
span.param-type, .params td .param-type, .param-type dd {
|
|
||||||
color: #606;
|
|
||||||
font-family: Consolas, Monaco, 'Andale Mono', monospace
|
|
||||||
}
|
|
||||||
|
|
||||||
.param-type dt, .param-type dd {
|
|
||||||
display: inline-block
|
|
||||||
}
|
|
||||||
|
|
||||||
.param-type {
|
|
||||||
margin: 14px 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
.disabled {
|
|
||||||
color: #454545
|
|
||||||
}
|
|
||||||
|
|
||||||
/* navicon button */
|
|
||||||
.navicon-button {
|
|
||||||
display: none;
|
|
||||||
position: relative;
|
|
||||||
padding: 2.0625rem 1.5rem;
|
|
||||||
transition: 0.25s;
|
|
||||||
cursor: pointer;
|
|
||||||
-webkit-user-select: none;
|
|
||||||
-moz-user-select: none;
|
|
||||||
-ms-user-select: none;
|
|
||||||
user-select: none;
|
|
||||||
opacity: .8;
|
|
||||||
}
|
|
||||||
.navicon-button .navicon:before, .navicon-button .navicon:after {
|
|
||||||
transition: 0.25s;
|
|
||||||
}
|
|
||||||
.navicon-button:hover {
|
|
||||||
transition: 0.5s;
|
|
||||||
opacity: 1;
|
|
||||||
}
|
|
||||||
.navicon-button:hover .navicon:before, .navicon-button:hover .navicon:after {
|
|
||||||
transition: 0.25s;
|
|
||||||
}
|
|
||||||
.navicon-button:hover .navicon:before {
|
|
||||||
top: .825rem;
|
|
||||||
}
|
|
||||||
.navicon-button:hover .navicon:after {
|
|
||||||
top: -.825rem;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* navicon */
|
|
||||||
.navicon {
|
|
||||||
position: relative;
|
|
||||||
width: 2.5em;
|
|
||||||
height: .3125rem;
|
|
||||||
background: #000;
|
|
||||||
transition: 0.3s;
|
|
||||||
border-radius: 2.5rem;
|
|
||||||
}
|
|
||||||
.navicon:before, .navicon:after {
|
|
||||||
display: block;
|
|
||||||
content: "";
|
|
||||||
height: .3125rem;
|
|
||||||
width: 2.5rem;
|
|
||||||
background: #000;
|
|
||||||
position: absolute;
|
|
||||||
z-index: -1;
|
|
||||||
transition: 0.3s 0.25s;
|
|
||||||
border-radius: 1rem;
|
|
||||||
}
|
|
||||||
.navicon:before {
|
|
||||||
top: .625rem;
|
|
||||||
}
|
|
||||||
.navicon:after {
|
|
||||||
top: -.625rem;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* open */
|
|
||||||
.nav-trigger:checked + label:not(.steps) .navicon:before,
|
|
||||||
.nav-trigger:checked + label:not(.steps) .navicon:after {
|
|
||||||
top: 0 !important;
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger:checked + label .navicon:before,
|
|
||||||
.nav-trigger:checked + label .navicon:after {
|
|
||||||
transition: 0.5s;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Minus */
|
|
||||||
.nav-trigger:checked + label {
|
|
||||||
-webkit-transform: scale(0.75);
|
|
||||||
transform: scale(0.75);
|
|
||||||
}
|
|
||||||
|
|
||||||
/* × and + */
|
|
||||||
.nav-trigger:checked + label.plus .navicon,
|
|
||||||
.nav-trigger:checked + label.x .navicon {
|
|
||||||
background: transparent;
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger:checked + label.plus .navicon:before,
|
|
||||||
.nav-trigger:checked + label.x .navicon:before {
|
|
||||||
-webkit-transform: rotate(-45deg);
|
|
||||||
transform: rotate(-45deg);
|
|
||||||
background: #FFF;
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger:checked + label.plus .navicon:after,
|
|
||||||
.nav-trigger:checked + label.x .navicon:after {
|
|
||||||
-webkit-transform: rotate(45deg);
|
|
||||||
transform: rotate(45deg);
|
|
||||||
background: #FFF;
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger:checked + label.plus {
|
|
||||||
-webkit-transform: scale(0.75) rotate(45deg);
|
|
||||||
transform: scale(0.75) rotate(45deg);
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger:checked ~ nav {
|
|
||||||
left: 0 !important;
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger:checked ~ .overlay {
|
|
||||||
display: block;
|
|
||||||
}
|
|
||||||
|
|
||||||
.nav-trigger {
|
|
||||||
position: fixed;
|
|
||||||
top: 0;
|
|
||||||
clip: rect(0, 0, 0, 0);
|
|
||||||
}
|
|
||||||
|
|
||||||
.overlay {
|
|
||||||
display: none;
|
|
||||||
position: fixed;
|
|
||||||
top: 0;
|
|
||||||
bottom: 0;
|
|
||||||
left: 0;
|
|
||||||
right: 0;
|
|
||||||
width: 100%;
|
|
||||||
height: 100%;
|
|
||||||
background: hsla(0, 0%, 0%, 0.5);
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
nav {
|
|
||||||
background: #FFF;
|
|
||||||
width: 250px;
|
|
||||||
height: 100%;
|
|
||||||
position: fixed;
|
|
||||||
top: 0;
|
|
||||||
right: 0;
|
|
||||||
bottom: 0;
|
|
||||||
left: -250px;
|
|
||||||
z-index: 3;
|
|
||||||
padding: 0 10px;
|
|
||||||
transition: left 0.2s;
|
|
||||||
}
|
|
||||||
|
|
||||||
.navicon-button {
|
|
||||||
display: inline-block;
|
|
||||||
position: fixed;
|
|
||||||
top: 1.5em;
|
|
||||||
right: 0;
|
|
||||||
z-index: 2;
|
|
||||||
}
|
|
||||||
|
|
||||||
#main {
|
|
||||||
width: 100%;
|
|
||||||
min-width: 360px;
|
|
||||||
}
|
|
||||||
|
|
||||||
#main h1.page-title {
|
|
||||||
margin: 1em 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
#main section {
|
|
||||||
padding: 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
footer {
|
|
||||||
margin-left: 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Add a '#' to static members */
|
|
||||||
[data-type="member"] a::before {
|
|
||||||
content: '#';
|
|
||||||
display: inline-block;
|
|
||||||
margin-left: -14px;
|
|
||||||
margin-right: 5px;
|
|
||||||
}
|
|
||||||
|
|
||||||
#disqus_thread{
|
|
||||||
margin-left: 30px;
|
|
||||||
}
|
|
||||||
@ -1,79 +0,0 @@
|
|||||||
.pln {
|
|
||||||
color: #ddd;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* string content */
|
|
||||||
.str {
|
|
||||||
color: #61ce3c;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a keyword */
|
|
||||||
.kwd {
|
|
||||||
color: #fbde2d;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a comment */
|
|
||||||
.com {
|
|
||||||
color: #aeaeae;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a type name */
|
|
||||||
.typ {
|
|
||||||
color: #8da6ce;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a literal value */
|
|
||||||
.lit {
|
|
||||||
color: #fbde2d;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* punctuation */
|
|
||||||
.pun {
|
|
||||||
color: #ddd;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* lisp open bracket */
|
|
||||||
.opn {
|
|
||||||
color: #000000;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* lisp close bracket */
|
|
||||||
.clo {
|
|
||||||
color: #000000;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a markup tag name */
|
|
||||||
.tag {
|
|
||||||
color: #8da6ce;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a markup attribute name */
|
|
||||||
.atn {
|
|
||||||
color: #fbde2d;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a markup attribute value */
|
|
||||||
.atv {
|
|
||||||
color: #ddd;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a declaration */
|
|
||||||
.dec {
|
|
||||||
color: #EF5050;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a variable name */
|
|
||||||
.var {
|
|
||||||
color: #c82829;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* a function name */
|
|
||||||
.fun {
|
|
||||||
color: #4271ae;
|
|
||||||
}
|
|
||||||
|
|
||||||
/* Specify class=linenums on a pre to get line numbering */
|
|
||||||
ol.linenums {
|
|
||||||
margin-top: 0;
|
|
||||||
margin-bottom: 0;
|
|
||||||
}
|
|
||||||
@ -1,378 +0,0 @@
|
|||||||
<!DOCTYPE html>
|
|
||||||
<html lang="en">
|
|
||||||
<head>
|
|
||||||
|
|
||||||
<meta charset="utf-8">
|
|
||||||
<title>utils.js - 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="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">
|
|
||||||
|
|
||||||
<h1 class="page-title">utils.js</h1>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<section>
|
|
||||||
<article>
|
|
||||||
<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
|
|
||||||
* @param {String} ua
|
|
||||||
* @return {Array|{index: number, input: string}|*|boolean|string}
|
|
||||||
*/
|
|
||||||
static getFirstMatch(regexp, ua) {
|
|
||||||
const match = ua.match(regexp);
|
|
||||||
return (match && match.length > 0 && match[1]) || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get second matched item for a string
|
|
||||||
* @param regexp
|
|
||||||
* @param {String} ua
|
|
||||||
* @return {Array|{index: number, input: string}|*|boolean|string}
|
|
||||||
*/
|
|
||||||
static getSecondMatch(regexp, ua) {
|
|
||||||
const match = ua.match(regexp);
|
|
||||||
return (match && match.length > 1 && match[2]) || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Match a regexp and return a constant or undefined
|
|
||||||
* @param {RegExp} regexp
|
|
||||||
* @param {String} ua
|
|
||||||
* @param {*} _const Any const that will be returned if regexp matches the string
|
|
||||||
* @return {*}
|
|
||||||
*/
|
|
||||||
static matchAndReturnConst(regexp, ua, _const) {
|
|
||||||
if (regexp.test(ua)) {
|
|
||||||
return _const;
|
|
||||||
}
|
|
||||||
return void (0);
|
|
||||||
}
|
|
||||||
|
|
||||||
static getWindowsVersionName(version) {
|
|
||||||
switch (version) {
|
|
||||||
case 'NT': return 'NT';
|
|
||||||
case 'XP': return 'XP';
|
|
||||||
case 'NT 5.0': return '2000';
|
|
||||||
case 'NT 5.1': return 'XP';
|
|
||||||
case 'NT 5.2': return '2003';
|
|
||||||
case 'NT 6.0': return 'Vista';
|
|
||||||
case 'NT 6.1': return '7';
|
|
||||||
case 'NT 6.2': return '8';
|
|
||||||
case 'NT 6.3': return '8.1';
|
|
||||||
case 'NT 10.0': return '10';
|
|
||||||
default: return undefined;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 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
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* getVersionPrecision("1.10.3") // 3
|
|
||||||
*
|
|
||||||
* @param {string} version
|
|
||||||
* @return {number}
|
|
||||||
*/
|
|
||||||
static getVersionPrecision(version) {
|
|
||||||
return version.split('.').length;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Calculate browser version weight
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* compareVersions('1.10.2.1', '1.8.2.1.90') // 1
|
|
||||||
* compareVersions('1.010.2.1', '1.09.2.1.90'); // 1
|
|
||||||
* compareVersions('1.10.2.1', '1.10.2.1'); // 0
|
|
||||||
* compareVersions('1.10.2.1', '1.0800.2'); // -1
|
|
||||||
* compareVersions('1.10.2.1', '1.10', true); // 0
|
|
||||||
*
|
|
||||||
* @param {String} versionA versions versions to compare
|
|
||||||
* @param {String} versionB versions versions to compare
|
|
||||||
* @param {boolean} [isLoose] enable loose comparison
|
|
||||||
* @return {Number} comparison result: -1 when versionA is lower,
|
|
||||||
* 1 when versionA is bigger, 0 when both equal
|
|
||||||
*/
|
|
||||||
/* eslint consistent-return: 1 */
|
|
||||||
static compareVersions(versionA, versionB, isLoose = false) {
|
|
||||||
// 1) get common precision for both versions, for example for "10.0" and "9" it should be 2
|
|
||||||
const versionAPrecision = Utils.getVersionPrecision(versionA);
|
|
||||||
const versionBPrecision = Utils.getVersionPrecision(versionB);
|
|
||||||
|
|
||||||
let precision = Math.max(versionAPrecision, versionBPrecision);
|
|
||||||
let lastPrecision = 0;
|
|
||||||
|
|
||||||
const chunks = Utils.map([versionA, versionB], (version) => {
|
|
||||||
const delta = precision - Utils.getVersionPrecision(version);
|
|
||||||
|
|
||||||
// 2) "9" -> "9.0" (for precision = 2)
|
|
||||||
const _version = version + new Array(delta + 1).join('.0');
|
|
||||||
|
|
||||||
// 3) "9.0" -> ["000000000"", "000000009"]
|
|
||||||
return Utils.map(_version.split('.'), chunk => new Array(20 - chunk.length).join('0') + chunk).reverse();
|
|
||||||
});
|
|
||||||
|
|
||||||
// adjust precision for loose comparison
|
|
||||||
if (isLoose) {
|
|
||||||
lastPrecision = precision - Math.min(versionAPrecision, versionBPrecision);
|
|
||||||
}
|
|
||||||
|
|
||||||
// iterate in reverse order by reversed chunks array
|
|
||||||
precision -= 1;
|
|
||||||
while (precision >= lastPrecision) {
|
|
||||||
// 4) compare: "000000009" > "000000010" = false (but "9" > "10" = true)
|
|
||||||
if (chunks[0][precision] > chunks[1][precision]) {
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (chunks[0][precision] === chunks[1][precision]) {
|
|
||||||
if (precision === lastPrecision) {
|
|
||||||
// all version chunks are same
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
precision -= 1;
|
|
||||||
} else if (chunks[0][precision] < chunks[1][precision]) {
|
|
||||||
return -1;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return undefined;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Array::map polyfill
|
|
||||||
*
|
|
||||||
* @param {Array} arr
|
|
||||||
* @param {Function} iterator
|
|
||||||
* @return {Array}
|
|
||||||
*/
|
|
||||||
static map(arr, iterator) {
|
|
||||||
const result = [];
|
|
||||||
let i;
|
|
||||||
if (Array.prototype.map) {
|
|
||||||
return Array.prototype.map.call(arr, iterator);
|
|
||||||
}
|
|
||||||
for (i = 0; i < arr.length; i += 1) {
|
|
||||||
result.push(iterator(arr[i]));
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 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 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>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br class="clear">
|
|
||||||
|
|
||||||
<footer>
|
|
||||||
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>
|
|
||||||
315
index.d.ts
vendored
315
index.d.ts
vendored
@ -1,315 +0,0 @@
|
|||||||
// 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;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
24
jsdoc.json
24
jsdoc.json
@ -1,24 +0,0 @@
|
|||||||
{
|
|
||||||
"tags": {
|
|
||||||
"allowUnknownTags": true
|
|
||||||
},
|
|
||||||
"source": {
|
|
||||||
"include": ["src", "README.md"],
|
|
||||||
"includePattern": ".js$",
|
|
||||||
"excludePattern": "(node_modules/|docs)"
|
|
||||||
},
|
|
||||||
"plugins": [
|
|
||||||
"plugins/markdown"
|
|
||||||
],
|
|
||||||
"opts": {
|
|
||||||
"template": "node_modules/docdash",
|
|
||||||
"encoding": "utf8",
|
|
||||||
"destination": "docs/",
|
|
||||||
"recurse": true,
|
|
||||||
"verbose": true
|
|
||||||
},
|
|
||||||
"templates": {
|
|
||||||
"cleverLinks": false,
|
|
||||||
"monospaceLinks": false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
24
make/build.js
Normal file
24
make/build.js
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
require('smoosh').config({
|
||||||
|
"JAVASCRIPT": {
|
||||||
|
"DIST_DIR": "./"
|
||||||
|
, "bowser": [
|
||||||
|
"./src/bowser.js"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
, "JSHINT_OPTS": {
|
||||||
|
"boss": true
|
||||||
|
, "forin": false
|
||||||
|
, "curly": false
|
||||||
|
, "debug": false
|
||||||
|
, "devel": false
|
||||||
|
, "evil": false
|
||||||
|
, "regexp": false
|
||||||
|
, "undef": false
|
||||||
|
, "sub": true
|
||||||
|
, "white": false
|
||||||
|
, "indent": 2
|
||||||
|
, "asi": true
|
||||||
|
, "laxbreak": true
|
||||||
|
, "laxcomma": true
|
||||||
|
}
|
||||||
|
}).run().build().analyze()
|
||||||
14506
package-lock.json
generated
14506
package-lock.json
generated
File diff suppressed because it is too large
Load Diff
63
package.json
63
package.json
@ -1,5 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "bowser",
|
"name": "bowser",
|
||||||
|
"version": "1.9.1",
|
||||||
"description": "Lightweight browser detector",
|
"description": "Lightweight browser detector",
|
||||||
"keywords": [
|
"keywords": [
|
||||||
"browser",
|
"browser",
|
||||||
@ -13,71 +14,25 @@
|
|||||||
],
|
],
|
||||||
"homepage": "https://github.com/lancedikson/bowser",
|
"homepage": "https://github.com/lancedikson/bowser",
|
||||||
"author": "Dustin Diaz <dustin@dustindiaz.com> (http://dustindiaz.com)",
|
"author": "Dustin Diaz <dustin@dustindiaz.com> (http://dustindiaz.com)",
|
||||||
"contributors": [
|
"main": "./src/bowser.js",
|
||||||
{
|
"typings": "./typings.d.ts",
|
||||||
"name": "Denis Demchenko",
|
|
||||||
"url": "http://twitter.com/lancedikson"
|
|
||||||
}
|
|
||||||
],
|
|
||||||
"main": "es5.js",
|
|
||||||
"browser": "es5.js",
|
|
||||||
"module": "src/bowser.js",
|
|
||||||
"types": "index.d.ts",
|
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
"url": "git+https://github.com/lancedikson/bowser.git"
|
"url": "git+https://github.com/ded/bowser.git"
|
||||||
},
|
},
|
||||||
"devDependencies": {
|
"devDependencies": {
|
||||||
"@babel/cli": "^7.11.6",
|
"smoosh": "*",
|
||||||
"@babel/core": "^7.8.0",
|
"mocha": "*"
|
||||||
"@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"
|
|
||||||
]
|
|
||||||
},
|
},
|
||||||
"bugs": {
|
"bugs": {
|
||||||
"url": "https://github.com/lancedikson/bowser/issues"
|
"url": "https://github.com/ded/bowser/issues"
|
||||||
},
|
},
|
||||||
"directories": {
|
"directories": {
|
||||||
"test": "test"
|
"test": "test"
|
||||||
},
|
},
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"build": "webpack --config webpack.config.js",
|
"test": "make test",
|
||||||
"generate-and-deploy-docs": "npm run generate-docs && gh-pages --dist docs --dest docs",
|
"prepublish": "make boosh"
|
||||||
"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",
|
|
||||||
"generate-docs": "jsdoc -c jsdoc.json"
|
|
||||||
},
|
},
|
||||||
"license": "MIT"
|
"license": "MIT"
|
||||||
}
|
}
|
||||||
|
|||||||
653
src/bowser.js
653
src/bowser.js
@ -1,77 +1,620 @@
|
|||||||
/*!
|
/*!
|
||||||
* Bowser - a browser detector
|
* Bowser - a browser detector
|
||||||
* https://github.com/lancedikson/bowser
|
* https://github.com/ded/bowser
|
||||||
* MIT License | (c) Dustin Diaz 2012-2015
|
* MIT License | (c) Dustin Diaz 2015
|
||||||
* MIT License | (c) Denis Demchenko 2015-2019
|
|
||||||
*/
|
*/
|
||||||
import Parser from './parser.js';
|
|
||||||
import {
|
|
||||||
BROWSER_MAP,
|
|
||||||
ENGINE_MAP,
|
|
||||||
OS_MAP,
|
|
||||||
PLATFORMS_MAP,
|
|
||||||
} from './constants.js';
|
|
||||||
|
|
||||||
/**
|
!function (root, name, definition) {
|
||||||
* Bowser class.
|
if (typeof module != 'undefined' && module.exports) module.exports = definition()
|
||||||
* Keep it simple as much as it can be.
|
else if (typeof define == 'function' && define.amd) define(name, definition)
|
||||||
* It's supposed to work with collections of {@link Parser} instances
|
else root[name] = definition()
|
||||||
* rather then solve one-instance problems.
|
}(this, 'bowser', function () {
|
||||||
* 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 Parser} instance
|
* See useragents.js for examples of navigator.userAgent
|
||||||
*
|
*/
|
||||||
* @param {String} UA UserAgent string
|
|
||||||
* @param {Boolean} [skipParsing=false] Will make the Parser postpone parsing until you ask it
|
var t = true
|
||||||
* explicitly. Same as `skipParsing` for {@link Parser}.
|
|
||||||
* @returns {Parser}
|
function detect(ua) {
|
||||||
* @throws {Error} when UA is not a String
|
|
||||||
*
|
function getFirstMatch(regex) {
|
||||||
* @example
|
var match = ua.match(regex);
|
||||||
* const parser = Bowser.getParser(window.navigator.userAgent);
|
return (match && match.length > 1 && match[1]) || '';
|
||||||
* const result = parser.getResult();
|
|
||||||
*/
|
|
||||||
static getParser(UA, skipParsing = false) {
|
|
||||||
if (typeof UA !== 'string') {
|
|
||||||
throw new Error('UserAgent should be a string');
|
|
||||||
}
|
}
|
||||||
return new Parser(UA, skipParsing);
|
|
||||||
|
function getSecondMatch(regex) {
|
||||||
|
var match = ua.match(regex);
|
||||||
|
return (match && match.length > 1 && match[2]) || '';
|
||||||
|
}
|
||||||
|
|
||||||
|
var iosdevice = getFirstMatch(/(ipod|iphone|ipad)/i).toLowerCase()
|
||||||
|
, likeAndroid = /like android/i.test(ua)
|
||||||
|
, android = !likeAndroid && /android/i.test(ua)
|
||||||
|
, nexusMobile = /nexus\s*[0-6]\s*/i.test(ua)
|
||||||
|
, nexusTablet = !nexusMobile && /nexus\s*[0-9]+/i.test(ua)
|
||||||
|
, chromeos = /CrOS/.test(ua)
|
||||||
|
, silk = /silk/i.test(ua)
|
||||||
|
, sailfish = /sailfish/i.test(ua)
|
||||||
|
, tizen = /tizen/i.test(ua)
|
||||||
|
, webos = /(web|hpw)os/i.test(ua)
|
||||||
|
, windowsphone = /windows phone/i.test(ua)
|
||||||
|
, samsungBrowser = /SamsungBrowser/i.test(ua)
|
||||||
|
, windows = !windowsphone && /windows/i.test(ua)
|
||||||
|
, mac = !iosdevice && !silk && /macintosh/i.test(ua)
|
||||||
|
, linux = !android && !sailfish && !tizen && !webos && /linux/i.test(ua)
|
||||||
|
, edgeVersion = getSecondMatch(/edg([ea]|ios)\/(\d+(\.\d+)?)/i)
|
||||||
|
, versionIdentifier = getFirstMatch(/version\/(\d+(\.\d+)?)/i)
|
||||||
|
, tablet = /tablet/i.test(ua) && !/tablet pc/i.test(ua)
|
||||||
|
, mobile = !tablet && /[^-]mobi/i.test(ua)
|
||||||
|
, xbox = /xbox/i.test(ua)
|
||||||
|
, result
|
||||||
|
|
||||||
|
if (/opera/i.test(ua)) {
|
||||||
|
// an old Opera
|
||||||
|
result = {
|
||||||
|
name: 'Opera'
|
||||||
|
, opera: t
|
||||||
|
, version: versionIdentifier || getFirstMatch(/(?:opera|opr|opios)[\s\/](\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
} else if (/opr\/|opios/i.test(ua)) {
|
||||||
|
// a new Opera
|
||||||
|
result = {
|
||||||
|
name: 'Opera'
|
||||||
|
, opera: t
|
||||||
|
, version: getFirstMatch(/(?:opr|opios)[\s\/](\d+(\.\d+)?)/i) || versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/SamsungBrowser/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Samsung Internet for Android'
|
||||||
|
, samsungBrowser: t
|
||||||
|
, version: versionIdentifier || getFirstMatch(/(?:SamsungBrowser)[\s\/](\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/coast/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Opera Coast'
|
||||||
|
, coast: t
|
||||||
|
, version: versionIdentifier || getFirstMatch(/(?:coast)[\s\/](\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/yabrowser/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Yandex Browser'
|
||||||
|
, yandexbrowser: t
|
||||||
|
, version: versionIdentifier || getFirstMatch(/(?:yabrowser)[\s\/](\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/ucbrowser/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'UC Browser'
|
||||||
|
, ucbrowser: t
|
||||||
|
, version: getFirstMatch(/(?:ucbrowser)[\s\/](\d+(?:\.\d+)+)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/mxios/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Maxthon'
|
||||||
|
, maxthon: t
|
||||||
|
, version: getFirstMatch(/(?:mxios)[\s\/](\d+(?:\.\d+)+)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/epiphany/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Epiphany'
|
||||||
|
, epiphany: t
|
||||||
|
, version: getFirstMatch(/(?:epiphany)[\s\/](\d+(?:\.\d+)+)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/puffin/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Puffin'
|
||||||
|
, puffin: t
|
||||||
|
, version: getFirstMatch(/(?:puffin)[\s\/](\d+(?:\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/sleipnir/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Sleipnir'
|
||||||
|
, sleipnir: t
|
||||||
|
, version: getFirstMatch(/(?:sleipnir)[\s\/](\d+(?:\.\d+)+)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/k-meleon/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'K-Meleon'
|
||||||
|
, kMeleon: t
|
||||||
|
, version: getFirstMatch(/(?:k-meleon)[\s\/](\d+(?:\.\d+)+)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (windowsphone) {
|
||||||
|
result = {
|
||||||
|
name: 'Windows Phone'
|
||||||
|
, osname: 'Windows Phone'
|
||||||
|
, windowsphone: t
|
||||||
|
}
|
||||||
|
if (edgeVersion) {
|
||||||
|
result.msedge = t
|
||||||
|
result.version = edgeVersion
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
result.msie = t
|
||||||
|
result.version = getFirstMatch(/iemobile\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/msie|trident/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Internet Explorer'
|
||||||
|
, msie: t
|
||||||
|
, version: getFirstMatch(/(?:msie |rv:)(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
} else if (chromeos) {
|
||||||
|
result = {
|
||||||
|
name: 'Chrome'
|
||||||
|
, osname: 'Chrome OS'
|
||||||
|
, chromeos: t
|
||||||
|
, chromeBook: t
|
||||||
|
, chrome: t
|
||||||
|
, version: getFirstMatch(/(?:chrome|crios|crmo)\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
} else if (/edg([ea]|ios)/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Microsoft Edge'
|
||||||
|
, msedge: t
|
||||||
|
, version: edgeVersion
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/vivaldi/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Vivaldi'
|
||||||
|
, vivaldi: t
|
||||||
|
, version: getFirstMatch(/vivaldi\/(\d+(\.\d+)?)/i) || versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (sailfish) {
|
||||||
|
result = {
|
||||||
|
name: 'Sailfish'
|
||||||
|
, osname: 'Sailfish OS'
|
||||||
|
, sailfish: t
|
||||||
|
, version: getFirstMatch(/sailfish\s?browser\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/seamonkey\//i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'SeaMonkey'
|
||||||
|
, seamonkey: t
|
||||||
|
, version: getFirstMatch(/seamonkey\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/firefox|iceweasel|fxios/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Firefox'
|
||||||
|
, firefox: t
|
||||||
|
, version: getFirstMatch(/(?:firefox|iceweasel|fxios)[ \/](\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
if (/\((mobile|tablet);[^\)]*rv:[\d\.]+\)/i.test(ua)) {
|
||||||
|
result.firefoxos = t
|
||||||
|
result.osname = 'Firefox OS'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (silk) {
|
||||||
|
result = {
|
||||||
|
name: 'Amazon Silk'
|
||||||
|
, silk: t
|
||||||
|
, version : getFirstMatch(/silk\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/phantom/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'PhantomJS'
|
||||||
|
, phantom: t
|
||||||
|
, version: getFirstMatch(/phantomjs\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/slimerjs/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'SlimerJS'
|
||||||
|
, slimer: t
|
||||||
|
, version: getFirstMatch(/slimerjs\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/blackberry|\bbb\d+/i.test(ua) || /rim\stablet/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'BlackBerry'
|
||||||
|
, osname: 'BlackBerry OS'
|
||||||
|
, blackberry: t
|
||||||
|
, version: versionIdentifier || getFirstMatch(/blackberry[\d]+\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (webos) {
|
||||||
|
result = {
|
||||||
|
name: 'WebOS'
|
||||||
|
, osname: 'WebOS'
|
||||||
|
, webos: t
|
||||||
|
, version: versionIdentifier || getFirstMatch(/w(?:eb)?osbrowser\/(\d+(\.\d+)?)/i)
|
||||||
|
};
|
||||||
|
/touchpad\//i.test(ua) && (result.touchpad = t)
|
||||||
|
}
|
||||||
|
else if (/bada/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Bada'
|
||||||
|
, osname: 'Bada'
|
||||||
|
, bada: t
|
||||||
|
, version: getFirstMatch(/dolfin\/(\d+(\.\d+)?)/i)
|
||||||
|
};
|
||||||
|
}
|
||||||
|
else if (tizen) {
|
||||||
|
result = {
|
||||||
|
name: 'Tizen'
|
||||||
|
, osname: 'Tizen'
|
||||||
|
, tizen: t
|
||||||
|
, version: getFirstMatch(/(?:tizen\s?)?browser\/(\d+(\.\d+)?)/i) || versionIdentifier
|
||||||
|
};
|
||||||
|
}
|
||||||
|
else if (/qupzilla/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'QupZilla'
|
||||||
|
, qupzilla: t
|
||||||
|
, version: getFirstMatch(/(?:qupzilla)[\s\/](\d+(?:\.\d+)+)/i) || versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/chromium/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Chromium'
|
||||||
|
, chromium: t
|
||||||
|
, version: getFirstMatch(/(?:chromium)[\s\/](\d+(?:\.\d+)?)/i) || versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/chrome|crios|crmo/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Chrome'
|
||||||
|
, chrome: t
|
||||||
|
, version: getFirstMatch(/(?:chrome|crios|crmo)\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (android) {
|
||||||
|
result = {
|
||||||
|
name: 'Android'
|
||||||
|
, version: versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (/safari|applewebkit/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Safari'
|
||||||
|
, safari: t
|
||||||
|
}
|
||||||
|
if (versionIdentifier) {
|
||||||
|
result.version = versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if (iosdevice) {
|
||||||
|
result = {
|
||||||
|
name : iosdevice == 'iphone' ? 'iPhone' : iosdevice == 'ipad' ? 'iPad' : 'iPod'
|
||||||
|
}
|
||||||
|
// WTF: version is not part of user agent in web apps
|
||||||
|
if (versionIdentifier) {
|
||||||
|
result.version = versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if(/googlebot/i.test(ua)) {
|
||||||
|
result = {
|
||||||
|
name: 'Googlebot'
|
||||||
|
, googlebot: t
|
||||||
|
, version: getFirstMatch(/googlebot\/(\d+(\.\d+))/i) || versionIdentifier
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
result = {
|
||||||
|
name: getFirstMatch(/^(.*)\/(.*) /),
|
||||||
|
version: getSecondMatch(/^(.*)\/(.*) /)
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// set webkit or gecko flag for browsers based on these engines
|
||||||
|
if (!result.msedge && /(apple)?webkit/i.test(ua)) {
|
||||||
|
if (/(apple)?webkit\/537\.36/i.test(ua)) {
|
||||||
|
result.name = result.name || "Blink"
|
||||||
|
result.blink = t
|
||||||
|
} else {
|
||||||
|
result.name = result.name || "Webkit"
|
||||||
|
result.webkit = t
|
||||||
|
}
|
||||||
|
if (!result.version && versionIdentifier) {
|
||||||
|
result.version = versionIdentifier
|
||||||
|
}
|
||||||
|
} else if (!result.opera && /gecko\//i.test(ua)) {
|
||||||
|
result.name = result.name || "Gecko"
|
||||||
|
result.gecko = t
|
||||||
|
result.version = result.version || getFirstMatch(/gecko\/(\d+(\.\d+)?)/i)
|
||||||
|
}
|
||||||
|
|
||||||
|
// set OS flags for platforms that have multiple browsers
|
||||||
|
if (!result.windowsphone && (android || result.silk)) {
|
||||||
|
result.android = t
|
||||||
|
result.osname = 'Android'
|
||||||
|
} else if (!result.windowsphone && iosdevice) {
|
||||||
|
result[iosdevice] = t
|
||||||
|
result.ios = t
|
||||||
|
result.osname = 'iOS'
|
||||||
|
} else if (mac) {
|
||||||
|
result.mac = t
|
||||||
|
result.osname = 'macOS'
|
||||||
|
} else if (xbox) {
|
||||||
|
result.xbox = t
|
||||||
|
result.osname = 'Xbox'
|
||||||
|
} else if (windows) {
|
||||||
|
result.windows = t
|
||||||
|
result.osname = 'Windows'
|
||||||
|
} else if (linux) {
|
||||||
|
result.linux = t
|
||||||
|
result.osname = 'Linux'
|
||||||
|
}
|
||||||
|
|
||||||
|
function getWindowsVersion (s) {
|
||||||
|
switch (s) {
|
||||||
|
case 'NT': return 'NT'
|
||||||
|
case 'XP': return 'XP'
|
||||||
|
case 'NT 5.0': return '2000'
|
||||||
|
case 'NT 5.1': return 'XP'
|
||||||
|
case 'NT 5.2': return '2003'
|
||||||
|
case 'NT 6.0': return 'Vista'
|
||||||
|
case 'NT 6.1': return '7'
|
||||||
|
case 'NT 6.2': return '8'
|
||||||
|
case 'NT 6.3': return '8.1'
|
||||||
|
case 'NT 10.0': return '10'
|
||||||
|
default: return undefined
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// OS version extraction
|
||||||
|
var osVersion = '';
|
||||||
|
if (result.windows) {
|
||||||
|
osVersion = getWindowsVersion(getFirstMatch(/Windows ((NT|XP)( \d\d?.\d)?)/i))
|
||||||
|
} else if (result.windowsphone) {
|
||||||
|
osVersion = getFirstMatch(/windows phone (?:os)?\s?(\d+(\.\d+)*)/i);
|
||||||
|
} else if (result.mac) {
|
||||||
|
osVersion = getFirstMatch(/Mac OS X (\d+([_\.\s]\d+)*)/i);
|
||||||
|
osVersion = osVersion.replace(/[_\s]/g, '.');
|
||||||
|
} else if (iosdevice) {
|
||||||
|
osVersion = getFirstMatch(/os (\d+([_\s]\d+)*) like mac os x/i);
|
||||||
|
osVersion = osVersion.replace(/[_\s]/g, '.');
|
||||||
|
} else if (android) {
|
||||||
|
osVersion = getFirstMatch(/android[ \/-](\d+(\.\d+)*)/i);
|
||||||
|
} else if (result.webos) {
|
||||||
|
osVersion = getFirstMatch(/(?:web|hpw)os\/(\d+(\.\d+)*)/i);
|
||||||
|
} else if (result.blackberry) {
|
||||||
|
osVersion = getFirstMatch(/rim\stablet\sos\s(\d+(\.\d+)*)/i);
|
||||||
|
} else if (result.bada) {
|
||||||
|
osVersion = getFirstMatch(/bada\/(\d+(\.\d+)*)/i);
|
||||||
|
} else if (result.tizen) {
|
||||||
|
osVersion = getFirstMatch(/tizen[\/\s](\d+(\.\d+)*)/i);
|
||||||
|
}
|
||||||
|
if (osVersion) {
|
||||||
|
result.osversion = osVersion;
|
||||||
|
}
|
||||||
|
|
||||||
|
// device type extraction
|
||||||
|
var osMajorVersion = !result.windows && osVersion.split('.')[0];
|
||||||
|
if (
|
||||||
|
tablet
|
||||||
|
|| nexusTablet
|
||||||
|
|| iosdevice == 'ipad'
|
||||||
|
|| (android && (osMajorVersion == 3 || (osMajorVersion >= 4 && !mobile)))
|
||||||
|
|| result.silk
|
||||||
|
) {
|
||||||
|
result.tablet = t
|
||||||
|
} else if (
|
||||||
|
mobile
|
||||||
|
|| iosdevice == 'iphone'
|
||||||
|
|| iosdevice == 'ipod'
|
||||||
|
|| android
|
||||||
|
|| nexusMobile
|
||||||
|
|| result.blackberry
|
||||||
|
|| result.webos
|
||||||
|
|| result.bada
|
||||||
|
) {
|
||||||
|
result.mobile = t
|
||||||
|
}
|
||||||
|
|
||||||
|
// Graded Browser Support
|
||||||
|
// http://developer.yahoo.com/yui/articles/gbs
|
||||||
|
if (result.msedge ||
|
||||||
|
(result.msie && result.version >= 10) ||
|
||||||
|
(result.yandexbrowser && result.version >= 15) ||
|
||||||
|
(result.vivaldi && result.version >= 1.0) ||
|
||||||
|
(result.chrome && result.version >= 20) ||
|
||||||
|
(result.samsungBrowser && result.version >= 4) ||
|
||||||
|
(result.firefox && result.version >= 20.0) ||
|
||||||
|
(result.safari && result.version >= 6) ||
|
||||||
|
(result.opera && result.version >= 10.0) ||
|
||||||
|
(result.ios && result.osversion && result.osversion.split(".")[0] >= 6) ||
|
||||||
|
(result.blackberry && result.version >= 10.1)
|
||||||
|
|| (result.chromium && result.version >= 20)
|
||||||
|
) {
|
||||||
|
result.a = t;
|
||||||
|
}
|
||||||
|
else if ((result.msie && result.version < 10) ||
|
||||||
|
(result.chrome && result.version < 20) ||
|
||||||
|
(result.firefox && result.version < 20.0) ||
|
||||||
|
(result.safari && result.version < 6) ||
|
||||||
|
(result.opera && result.version < 10.0) ||
|
||||||
|
(result.ios && result.osversion && result.osversion.split(".")[0] < 6)
|
||||||
|
|| (result.chromium && result.version < 20)
|
||||||
|
) {
|
||||||
|
result.c = t
|
||||||
|
} else result.x = t
|
||||||
|
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
|
||||||
|
var bowser = detect(typeof navigator !== 'undefined' ? navigator.userAgent || '' : '')
|
||||||
|
|
||||||
|
bowser.test = function (browserList) {
|
||||||
|
for (var i = 0; i < browserList.length; ++i) {
|
||||||
|
var browserItem = browserList[i];
|
||||||
|
if (typeof browserItem=== 'string') {
|
||||||
|
if (browserItem in bowser) {
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Creates a {@link Parser} instance and runs {@link Parser.getResult} immediately
|
* Get version precisions count
|
||||||
*
|
|
||||||
* @param UA
|
|
||||||
* @return {ParsedResult}
|
|
||||||
*
|
*
|
||||||
* @example
|
* @example
|
||||||
* const result = Bowser.parse(window.navigator.userAgent);
|
* getVersionPrecision("1.10.3") // 3
|
||||||
|
*
|
||||||
|
* @param {string} version
|
||||||
|
* @return {number}
|
||||||
*/
|
*/
|
||||||
static parse(UA) {
|
function getVersionPrecision(version) {
|
||||||
return (new Parser(UA)).getResult();
|
return version.split(".").length;
|
||||||
}
|
}
|
||||||
|
|
||||||
static get BROWSER_MAP() {
|
/**
|
||||||
return BROWSER_MAP;
|
* Array::map polyfill
|
||||||
|
*
|
||||||
|
* @param {Array} arr
|
||||||
|
* @param {Function} iterator
|
||||||
|
* @return {Array}
|
||||||
|
*/
|
||||||
|
function map(arr, iterator) {
|
||||||
|
var result = [], i;
|
||||||
|
if (Array.prototype.map) {
|
||||||
|
return Array.prototype.map.call(arr, iterator);
|
||||||
|
}
|
||||||
|
for (i = 0; i < arr.length; i++) {
|
||||||
|
result.push(iterator(arr[i]));
|
||||||
|
}
|
||||||
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
static get ENGINE_MAP() {
|
/**
|
||||||
return ENGINE_MAP;
|
* Calculate browser version weight
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* compareVersions(['1.10.2.1', '1.8.2.1.90']) // 1
|
||||||
|
* compareVersions(['1.010.2.1', '1.09.2.1.90']); // 1
|
||||||
|
* compareVersions(['1.10.2.1', '1.10.2.1']); // 0
|
||||||
|
* compareVersions(['1.10.2.1', '1.0800.2']); // -1
|
||||||
|
*
|
||||||
|
* @param {Array<String>} versions versions to compare
|
||||||
|
* @return {Number} comparison result
|
||||||
|
*/
|
||||||
|
function compareVersions(versions) {
|
||||||
|
// 1) get common precision for both versions, for example for "10.0" and "9" it should be 2
|
||||||
|
var precision = Math.max(getVersionPrecision(versions[0]), getVersionPrecision(versions[1]));
|
||||||
|
var chunks = map(versions, function (version) {
|
||||||
|
var delta = precision - getVersionPrecision(version);
|
||||||
|
|
||||||
|
// 2) "9" -> "9.0" (for precision = 2)
|
||||||
|
version = version + new Array(delta + 1).join(".0");
|
||||||
|
|
||||||
|
// 3) "9.0" -> ["000000000"", "000000009"]
|
||||||
|
return map(version.split("."), function (chunk) {
|
||||||
|
return new Array(20 - chunk.length).join("0") + chunk;
|
||||||
|
}).reverse();
|
||||||
|
});
|
||||||
|
|
||||||
|
// iterate in reverse order by reversed chunks array
|
||||||
|
while (--precision >= 0) {
|
||||||
|
// 4) compare: "000000009" > "000000010" = false (but "9" > "10" = true)
|
||||||
|
if (chunks[0][precision] > chunks[1][precision]) {
|
||||||
|
return 1;
|
||||||
|
}
|
||||||
|
else if (chunks[0][precision] === chunks[1][precision]) {
|
||||||
|
if (precision === 0) {
|
||||||
|
// all version chunks are same
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else {
|
||||||
|
return -1;
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
static get OS_MAP() {
|
/**
|
||||||
return OS_MAP;
|
* Check if browser is unsupported
|
||||||
|
*
|
||||||
|
* @example
|
||||||
|
* bowser.isUnsupportedBrowser({
|
||||||
|
* msie: "10",
|
||||||
|
* firefox: "23",
|
||||||
|
* chrome: "29",
|
||||||
|
* safari: "5.1",
|
||||||
|
* opera: "16",
|
||||||
|
* phantom: "534"
|
||||||
|
* });
|
||||||
|
*
|
||||||
|
* @param {Object} minVersions map of minimal version to browser
|
||||||
|
* @param {Boolean} [strictMode = false] flag to return false if browser wasn't found in map
|
||||||
|
* @param {String} [ua] user agent string
|
||||||
|
* @return {Boolean}
|
||||||
|
*/
|
||||||
|
function isUnsupportedBrowser(minVersions, strictMode, ua) {
|
||||||
|
var _bowser = bowser;
|
||||||
|
|
||||||
|
// make strictMode param optional with ua param usage
|
||||||
|
if (typeof strictMode === 'string') {
|
||||||
|
ua = strictMode;
|
||||||
|
strictMode = void(0);
|
||||||
|
}
|
||||||
|
|
||||||
|
if (strictMode === void(0)) {
|
||||||
|
strictMode = false;
|
||||||
|
}
|
||||||
|
if (ua) {
|
||||||
|
_bowser = detect(ua);
|
||||||
|
}
|
||||||
|
|
||||||
|
var version = "" + _bowser.version;
|
||||||
|
for (var browser in minVersions) {
|
||||||
|
if (minVersions.hasOwnProperty(browser)) {
|
||||||
|
if (_bowser[browser]) {
|
||||||
|
if (typeof minVersions[browser] !== 'string') {
|
||||||
|
throw new Error('Browser version in the minVersion map should be a string: ' + browser + ': ' + String(minVersions));
|
||||||
|
}
|
||||||
|
|
||||||
|
// browser version and min supported version.
|
||||||
|
return compareVersions([version, minVersions[browser]]) < 0;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return strictMode; // not found
|
||||||
}
|
}
|
||||||
|
|
||||||
static get PLATFORMS_MAP() {
|
/**
|
||||||
return PLATFORMS_MAP;
|
* Check if browser is supported
|
||||||
|
*
|
||||||
|
* @param {Object} minVersions map of minimal version to browser
|
||||||
|
* @param {Boolean} [strictMode = false] flag to return false if browser wasn't found in map
|
||||||
|
* @param {String} [ua] user agent string
|
||||||
|
* @return {Boolean}
|
||||||
|
*/
|
||||||
|
function check(minVersions, strictMode, ua) {
|
||||||
|
return !isUnsupportedBrowser(minVersions, strictMode, ua);
|
||||||
}
|
}
|
||||||
}
|
|
||||||
|
|
||||||
export default Bowser;
|
bowser.isUnsupportedBrowser = isUnsupportedBrowser;
|
||||||
|
bowser.compareVersions = compareVersions;
|
||||||
|
bowser.check = check;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Set our detect method to the main bowser object so we can
|
||||||
|
* reuse it to test other user agents.
|
||||||
|
* This is needed to implement future tests.
|
||||||
|
*/
|
||||||
|
bowser._detect = detect;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Set our detect public method to the main bowser object
|
||||||
|
* This is needed to implement bowser in server side
|
||||||
|
*/
|
||||||
|
bowser.detect = detect;
|
||||||
|
return bowser
|
||||||
|
});
|
||||||
|
|||||||
119
src/constants.js
119
src/constants.js
@ -1,119 +0,0 @@
|
|||||||
// 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',
|
|
||||||
};
|
|
||||||
@ -1,715 +0,0 @@
|
|||||||
/**
|
|
||||||
* Browsers' descriptors
|
|
||||||
*
|
|
||||||
* The idea of descriptors is simple. You should know about them two simple things:
|
|
||||||
* 1. Every descriptor has a method or property called `test` and a `describe` method.
|
|
||||||
* 2. Order of descriptors is important.
|
|
||||||
*
|
|
||||||
* More details:
|
|
||||||
* 1. Method or property `test` serves as a way to detect whether the UA string
|
|
||||||
* matches some certain browser or not. The `describe` method helps to make a result
|
|
||||||
* object with params that show some browser-specific things: name, version, etc.
|
|
||||||
* 2. Order of descriptors is important because a Parser goes through them one by one
|
|
||||||
* in course. For example, if you insert Chrome's descriptor as the first one,
|
|
||||||
* more then a half of browsers will be described as Chrome, because they will pass
|
|
||||||
* the Chrome descriptor's test.
|
|
||||||
*
|
|
||||||
* Descriptor's `test` could be a property with an array of RegExps, where every RegExp
|
|
||||||
* will be applied to a UA string to test it whether it matches or not.
|
|
||||||
* If a descriptor has two or more regexps in the `test` array it tests them one by one
|
|
||||||
* with a logical sum operation. Parser stops if it has found any RegExp that matches the UA.
|
|
||||||
*
|
|
||||||
* Or `test` could be a method. In that case it gets a Parser instance and should
|
|
||||||
* return true/false to get the Parser know if this browser descriptor matches the UA or not.
|
|
||||||
*/
|
|
||||||
|
|
||||||
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],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Opera',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:opera)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Opera > 13.0 */
|
|
||||||
{
|
|
||||||
test: [/opr\/|opios/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Opera',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:opr|opios)[\s/](\S+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/SamsungBrowser/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Samsung Internet for Android',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:SamsungBrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/Whale/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'NAVER Whale Browser',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/MZBrowser/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'MZ Browser',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:MZBrowser)[\s/](\d+(?:\.\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/focus/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Focus',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:focus)[\s/](\d+(?:\.\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/swing/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Swing',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:swing)[\s/](\d+(?:\.\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/coast/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Opera Coast',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/yabrowser/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Yandex Browser',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:yabrowser)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/ucbrowser/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'UC Browser',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:ucbrowser)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/Maxthon|mxios/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Maxthon',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:Maxthon|mxios)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/epiphany/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Epiphany',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:epiphany)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/puffin/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Puffin',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:puffin)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/sleipnir/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Sleipnir',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/(?:sleipnir)[\s/](\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/k-meleon/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'K-Meleon',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/msie|trident/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Internet Explorer',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/edg([ea]|ios)/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Microsoft Edge',
|
|
||||||
};
|
|
||||||
|
|
||||||
const version = Utils.getSecondMatch(/edg([ea]|ios)\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/vivaldi/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Vivaldi',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/vivaldi\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/seamonkey/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'SeaMonkey',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/seamonkey\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/sailfish/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Sailfish',
|
|
||||||
};
|
|
||||||
|
|
||||||
const version = Utils.getFirstMatch(/sailfish\s?browser\/(\d+(\.\d+)?)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/silk/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Amazon Silk',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/silk\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/phantom/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'PhantomJS',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/phantomjs\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/slimerjs/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'SlimerJS',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/slimerjs\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/blackberry|\bbb\d+/i, /rim\stablet/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'BlackBerry',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/blackberry[\d]+\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/(web|hpw)[o0]s/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'WebOS Browser',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua) || Utils.getFirstMatch(/w(?:eb)?[o0]sbrowser\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/bada/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Bada',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/dolfin\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/tizen/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Tizen',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:tizen\s?)?browser\/(\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/qupzilla/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'QupZilla',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:qupzilla)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/firefox|iceweasel|fxios/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Firefox',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/chromium/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Chromium',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(/(?:chromium)[\s/](\d+(\.?_?\d+)+)/i, ua) || Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
{
|
|
||||||
test: [/chrome|crios|crmo/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Chrome',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Android Browser */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
const notLikeAndroid = !parser.test(/like android/i);
|
|
||||||
const butAndroid = parser.test(/android/i);
|
|
||||||
return notLikeAndroid && butAndroid;
|
|
||||||
},
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Android Browser',
|
|
||||||
};
|
|
||||||
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;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Safari */
|
|
||||||
{
|
|
||||||
test: [/safari|applewebkit/i],
|
|
||||||
describe(ua) {
|
|
||||||
const browser = {
|
|
||||||
name: 'Safari',
|
|
||||||
};
|
|
||||||
const version = Utils.getFirstMatch(commonVersionIdentifier, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
browser.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return browser;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Something else */
|
|
||||||
{
|
|
||||||
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: Utils.getFirstMatch(regexp, ua),
|
|
||||||
version: Utils.getSecondMatch(regexp, ua),
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
];
|
|
||||||
|
|
||||||
export default browsersList;
|
|
||||||
@ -1,120 +0,0 @@
|
|||||||
import Utils from './utils.js';
|
|
||||||
import { ENGINE_MAP } from './constants.js';
|
|
||||||
|
|
||||||
/*
|
|
||||||
* More specific goes first
|
|
||||||
*/
|
|
||||||
export default [
|
|
||||||
/* EdgeHTML */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getBrowserName(true) === 'microsoft edge';
|
|
||||||
},
|
|
||||||
describe(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: ENGINE_MAP.EdgeHTML,
|
|
||||||
version,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Trident */
|
|
||||||
{
|
|
||||||
test: [/trident/i],
|
|
||||||
describe(ua) {
|
|
||||||
const engine = {
|
|
||||||
name: ENGINE_MAP.Trident,
|
|
||||||
};
|
|
||||||
|
|
||||||
const version = Utils.getFirstMatch(/trident\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
engine.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return engine;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Presto */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.test(/presto/i);
|
|
||||||
},
|
|
||||||
describe(ua) {
|
|
||||||
const engine = {
|
|
||||||
name: ENGINE_MAP.Presto,
|
|
||||||
};
|
|
||||||
|
|
||||||
const version = Utils.getFirstMatch(/presto\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
engine.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return engine;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Gecko */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
const isGecko = parser.test(/gecko/i);
|
|
||||||
const likeGecko = parser.test(/like gecko/i);
|
|
||||||
return isGecko && !likeGecko;
|
|
||||||
},
|
|
||||||
describe(ua) {
|
|
||||||
const engine = {
|
|
||||||
name: ENGINE_MAP.Gecko,
|
|
||||||
};
|
|
||||||
|
|
||||||
const version = Utils.getFirstMatch(/gecko\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
engine.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return engine;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Blink */
|
|
||||||
{
|
|
||||||
test: [/(apple)?webkit\/537\.36/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
name: ENGINE_MAP.Blink,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* WebKit */
|
|
||||||
{
|
|
||||||
test: [/(apple)?webkit/i],
|
|
||||||
describe(ua) {
|
|
||||||
const engine = {
|
|
||||||
name: ENGINE_MAP.WebKit,
|
|
||||||
};
|
|
||||||
|
|
||||||
const version = Utils.getFirstMatch(/webkit\/(\d+(\.?_?\d+)+)/i, ua);
|
|
||||||
|
|
||||||
if (version) {
|
|
||||||
engine.version = version;
|
|
||||||
}
|
|
||||||
|
|
||||||
return engine;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
];
|
|
||||||
199
src/parser-os.js
199
src/parser-os.js
@ -1,199 +0,0 @@
|
|||||||
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 = Utils.getFirstMatch(/windows phone (?:os)?\s?(\d+(\.\d+)*)/i, ua);
|
|
||||||
return {
|
|
||||||
name: OS_MAP.WindowsPhone,
|
|
||||||
version,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Windows */
|
|
||||||
{
|
|
||||||
test: [/windows /i],
|
|
||||||
describe(ua) {
|
|
||||||
const version = Utils.getFirstMatch(/Windows ((NT|XP)( \d\d?.\d)?)/i, ua);
|
|
||||||
const versionName = Utils.getWindowsVersionName(version);
|
|
||||||
|
|
||||||
return {
|
|
||||||
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 = 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;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* iOS */
|
|
||||||
{
|
|
||||||
test: [/(ipod|iphone|ipad)/i],
|
|
||||||
describe(ua) {
|
|
||||||
const version = Utils.getFirstMatch(/os (\d+([_\s]\d+)*) like mac os x/i, ua).replace(/[_\s]/g, '.');
|
|
||||||
|
|
||||||
return {
|
|
||||||
name: OS_MAP.iOS,
|
|
||||||
version,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Android */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
const notLikeAndroid = !parser.test(/like android/i);
|
|
||||||
const butAndroid = parser.test(/android/i);
|
|
||||||
return notLikeAndroid && butAndroid;
|
|
||||||
},
|
|
||||||
describe(ua) {
|
|
||||||
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;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* WebOS */
|
|
||||||
{
|
|
||||||
test: [/(web|hpw)[o0]s/i],
|
|
||||||
describe(ua) {
|
|
||||||
const version = Utils.getFirstMatch(/(?:web|hpw)[o0]s\/(\d+(\.\d+)*)/i, ua);
|
|
||||||
const os = {
|
|
||||||
name: OS_MAP.WebOS,
|
|
||||||
};
|
|
||||||
|
|
||||||
if (version && version.length) {
|
|
||||||
os.version = version;
|
|
||||||
}
|
|
||||||
return os;
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* BlackBerry */
|
|
||||||
{
|
|
||||||
test: [/blackberry|\bbb\d+/i, /rim\stablet/i],
|
|
||||||
describe(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: OS_MAP.BlackBerry,
|
|
||||||
version,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Bada */
|
|
||||||
{
|
|
||||||
test: [/bada/i],
|
|
||||||
describe(ua) {
|
|
||||||
const version = Utils.getFirstMatch(/bada\/(\d+(\.\d+)*)/i, ua);
|
|
||||||
|
|
||||||
return {
|
|
||||||
name: OS_MAP.Bada,
|
|
||||||
version,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Tizen */
|
|
||||||
{
|
|
||||||
test: [/tizen/i],
|
|
||||||
describe(ua) {
|
|
||||||
const version = Utils.getFirstMatch(/tizen[/\s](\d+(\.\d+)*)/i, ua);
|
|
||||||
|
|
||||||
return {
|
|
||||||
name: OS_MAP.Tizen,
|
|
||||||
version,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Linux */
|
|
||||||
{
|
|
||||||
test: [/linux/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
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,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
];
|
|
||||||
@ -1,282 +0,0 @@
|
|||||||
import Utils from './utils.js';
|
|
||||||
import { PLATFORMS_MAP } from './constants.js';
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Tablets go first since usually they have more specific
|
|
||||||
* signs to detect.
|
|
||||||
*/
|
|
||||||
|
|
||||||
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: PLATFORMS_MAP.tablet,
|
|
||||||
vendor: 'Nexus',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* iPad */
|
|
||||||
{
|
|
||||||
test: [/ipad/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.tablet,
|
|
||||||
vendor: 'Apple',
|
|
||||||
model: 'iPad',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Firefox on iPad */
|
|
||||||
{
|
|
||||||
test: [/Macintosh(.*?) FxiOS(.*?)\//],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.tablet,
|
|
||||||
vendor: 'Apple',
|
|
||||||
model: 'iPad',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Amazon Kindle Fire */
|
|
||||||
{
|
|
||||||
test: [/kftt build/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.tablet,
|
|
||||||
vendor: 'Amazon',
|
|
||||||
model: 'Kindle Fire HD 7',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Another Amazon Tablet with Silk */
|
|
||||||
{
|
|
||||||
test: [/silk/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.tablet,
|
|
||||||
vendor: 'Amazon',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Tablet */
|
|
||||||
{
|
|
||||||
test: [/tablet(?! pc)/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.tablet,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* iPod/iPhone */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
const iDevice = parser.test(/ipod|iphone/i);
|
|
||||||
const likeIDevice = parser.test(/like (ipod|iphone)/i);
|
|
||||||
return iDevice && !likeIDevice;
|
|
||||||
},
|
|
||||||
describe(ua) {
|
|
||||||
const model = Utils.getFirstMatch(/(ipod|iphone)/i, ua);
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.mobile,
|
|
||||||
vendor: 'Apple',
|
|
||||||
model,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Nexus Mobile */
|
|
||||||
{
|
|
||||||
test: [/nexus\s*[0-6].*/i, /galaxy nexus/i],
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
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: PLATFORMS_MAP.mobile,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* BlackBerry */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getBrowserName(true) === 'blackberry';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.mobile,
|
|
||||||
vendor: 'BlackBerry',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Bada */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getBrowserName(true) === 'bada';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.mobile,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Windows Phone */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getBrowserName() === 'windows phone';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.mobile,
|
|
||||||
vendor: 'Microsoft',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Android Tablet */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
const osMajorVersion = Number(String(parser.getOSVersion()).split('.')[0]);
|
|
||||||
return parser.getOSName(true) === 'android' && (osMajorVersion >= 3);
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.tablet,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Android Mobile */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getOSName(true) === 'android';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.mobile,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* desktop */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getOSName(true) === 'macos';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.desktop,
|
|
||||||
vendor: 'Apple',
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Windows */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getOSName(true) === 'windows';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
type: PLATFORMS_MAP.desktop,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
|
|
||||||
/* Linux */
|
|
||||||
{
|
|
||||||
test(parser) {
|
|
||||||
return parser.getOSName(true) === 'linux';
|
|
||||||
},
|
|
||||||
describe() {
|
|
||||||
return {
|
|
||||||
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,
|
|
||||||
};
|
|
||||||
},
|
|
||||||
},
|
|
||||||
];
|
|
||||||
511
src/parser.js
511
src/parser.js
@ -1,511 +0,0 @@
|
|||||||
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.
|
|
||||||
*/
|
|
||||||
class Parser {
|
|
||||||
/**
|
|
||||||
* Create instance of Parser
|
|
||||||
*
|
|
||||||
* @param {String} UA User-Agent string
|
|
||||||
* @param {Boolean} [skipParsing=false] parser can skip parsing in purpose of performance
|
|
||||||
* improvements if you need to make a more particular parsing
|
|
||||||
* like {@link Parser#parseBrowser} or {@link Parser#parsePlatform}
|
|
||||||
*
|
|
||||||
* @throw {Error} in case of empty UA String
|
|
||||||
*
|
|
||||||
* @constructor
|
|
||||||
*/
|
|
||||||
constructor(UA, skipParsing = false) {
|
|
||||||
if (UA === void (0) || UA === null || UA === '') {
|
|
||||||
throw new Error("UserAgent parameter can't be empty");
|
|
||||||
}
|
|
||||||
|
|
||||||
this._ua = UA;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @typedef ParsedResult
|
|
||||||
* @property {Object} browser
|
|
||||||
* @property {String|undefined} [browser.name]
|
|
||||||
* Browser name, like `"Chrome"` or `"Internet Explorer"`
|
|
||||||
* @property {String|undefined} [browser.version] Browser version as a String `"12.01.45334.10"`
|
|
||||||
* @property {Object} os
|
|
||||||
* @property {String|undefined} [os.name] OS name, like `"Windows"` or `"macOS"`
|
|
||||||
* @property {String|undefined} [os.version] OS version, like `"NT 5.1"` or `"10.11.1"`
|
|
||||||
* @property {String|undefined} [os.versionName] OS name, like `"XP"` or `"High Sierra"`
|
|
||||||
* @property {Object} platform
|
|
||||||
* @property {String|undefined} [platform.type]
|
|
||||||
* platform type, can be either `"desktop"`, `"tablet"` or `"mobile"`
|
|
||||||
* @property {String|undefined} [platform.vendor] Vendor of the device,
|
|
||||||
* like `"Apple"` or `"Samsung"`
|
|
||||||
* @property {String|undefined} [platform.model] Device model,
|
|
||||||
* like `"iPhone"` or `"Kindle Fire HD 7"`
|
|
||||||
* @property {Object} engine
|
|
||||||
* @property {String|undefined} [engine.name]
|
|
||||||
* Can be any of this: `WebKit`, `Blink`, `Gecko`, `Trident`, `Presto`, `EdgeHTML`
|
|
||||||
* @property {String|undefined} [engine.version] String version of the engine
|
|
||||||
*/
|
|
||||||
this.parsedResult = {};
|
|
||||||
|
|
||||||
if (skipParsing !== true) {
|
|
||||||
this.parse();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get UserAgent string of current Parser instance
|
|
||||||
* @return {String} User-Agent String of the current <Parser> object
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getUA() {
|
|
||||||
return this._ua;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Test a UA string for a regexp
|
|
||||||
* @param {RegExp} regex
|
|
||||||
* @return {Boolean}
|
|
||||||
*/
|
|
||||||
test(regex) {
|
|
||||||
return regex.test(this._ua);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed browser object
|
|
||||||
* @return {Object}
|
|
||||||
*/
|
|
||||||
parseBrowser() {
|
|
||||||
this.parsedResult.browser = {};
|
|
||||||
|
|
||||||
const browserDescriptor = Utils.find(browserParsersList, (_browser) => {
|
|
||||||
if (typeof _browser.test === 'function') {
|
|
||||||
return _browser.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (Array.isArray(_browser.test)) {
|
|
||||||
return _browser.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (browserDescriptor) {
|
|
||||||
this.parsedResult.browser = browserDescriptor.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.browser;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed browser object
|
|
||||||
* @return {Object}
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getBrowser() {
|
|
||||||
if (this.parsedResult.browser) {
|
|
||||||
return this.parsedResult.browser;
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parseBrowser();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get browser's name
|
|
||||||
* @return {String} Browser's name or an empty string
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getBrowserName(toLowerCase) {
|
|
||||||
if (toLowerCase) {
|
|
||||||
return String(this.getBrowser().name).toLowerCase() || '';
|
|
||||||
}
|
|
||||||
return this.getBrowser().name || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get browser's version
|
|
||||||
* @return {String} version of browser
|
|
||||||
*
|
|
||||||
* @public
|
|
||||||
*/
|
|
||||||
getBrowserVersion() {
|
|
||||||
return this.getBrowser().version;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get OS
|
|
||||||
* @return {Object}
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* this.getOS();
|
|
||||||
* {
|
|
||||||
* name: 'macOS',
|
|
||||||
* version: '10.11.12'
|
|
||||||
* }
|
|
||||||
*/
|
|
||||||
getOS() {
|
|
||||||
if (this.parsedResult.os) {
|
|
||||||
return this.parsedResult.os;
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parseOS();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse OS and save it to this.parsedResult.os
|
|
||||||
* @return {*|{}}
|
|
||||||
*/
|
|
||||||
parseOS() {
|
|
||||||
this.parsedResult.os = {};
|
|
||||||
|
|
||||||
const os = Utils.find(osParsersList, (_os) => {
|
|
||||||
if (typeof _os.test === 'function') {
|
|
||||||
return _os.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (Array.isArray(_os.test)) {
|
|
||||||
return _os.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (os) {
|
|
||||||
this.parsedResult.os = os.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.os;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get OS name
|
|
||||||
* @param {Boolean} [toLowerCase] return lower-cased value
|
|
||||||
* @return {String} name of the OS — macOS, Windows, Linux, etc.
|
|
||||||
*/
|
|
||||||
getOSName(toLowerCase) {
|
|
||||||
const { name } = this.getOS();
|
|
||||||
|
|
||||||
if (toLowerCase) {
|
|
||||||
return String(name).toLowerCase() || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
return name || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get OS version
|
|
||||||
* @return {String} full version with dots ('10.11.12', '5.6', etc)
|
|
||||||
*/
|
|
||||||
getOSVersion() {
|
|
||||||
return this.getOS().version;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed platform
|
|
||||||
* @return {{}}
|
|
||||||
*/
|
|
||||||
getPlatform() {
|
|
||||||
if (this.parsedResult.platform) {
|
|
||||||
return this.parsedResult.platform;
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsePlatform();
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get platform name
|
|
||||||
* @param {Boolean} [toLowerCase=false]
|
|
||||||
* @return {*}
|
|
||||||
*/
|
|
||||||
getPlatformType(toLowerCase = false) {
|
|
||||||
const { type } = this.getPlatform();
|
|
||||||
|
|
||||||
if (toLowerCase) {
|
|
||||||
return String(type).toLowerCase() || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
return type || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed platform
|
|
||||||
* @return {{}}
|
|
||||||
*/
|
|
||||||
parsePlatform() {
|
|
||||||
this.parsedResult.platform = {};
|
|
||||||
|
|
||||||
const platform = Utils.find(platformParsersList, (_platform) => {
|
|
||||||
if (typeof _platform.test === 'function') {
|
|
||||||
return _platform.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (Array.isArray(_platform.test)) {
|
|
||||||
return _platform.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (platform) {
|
|
||||||
this.parsedResult.platform = platform.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.platform;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed engine
|
|
||||||
* @return {{}}
|
|
||||||
*/
|
|
||||||
getEngine() {
|
|
||||||
if (this.parsedResult.engine) {
|
|
||||||
return this.parsedResult.engine;
|
|
||||||
}
|
|
||||||
|
|
||||||
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 {{}}
|
|
||||||
*/
|
|
||||||
parseEngine() {
|
|
||||||
this.parsedResult.engine = {};
|
|
||||||
|
|
||||||
const engine = Utils.find(enginesParsersList, (_engine) => {
|
|
||||||
if (typeof _engine.test === 'function') {
|
|
||||||
return _engine.test(this);
|
|
||||||
}
|
|
||||||
|
|
||||||
if (Array.isArray(_engine.test)) {
|
|
||||||
return _engine.test.some(condition => this.test(condition));
|
|
||||||
}
|
|
||||||
|
|
||||||
throw new Error("Browser's test function is not valid");
|
|
||||||
});
|
|
||||||
|
|
||||||
if (engine) {
|
|
||||||
this.parsedResult.engine = engine.describe(this.getUA());
|
|
||||||
}
|
|
||||||
|
|
||||||
return this.parsedResult.engine;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Parse full information about the browser
|
|
||||||
* @returns {Parser}
|
|
||||||
*/
|
|
||||||
parse() {
|
|
||||||
this.parseBrowser();
|
|
||||||
this.parseOS();
|
|
||||||
this.parsePlatform();
|
|
||||||
this.parseEngine();
|
|
||||||
|
|
||||||
return this;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get parsed result
|
|
||||||
* @return {ParsedResult}
|
|
||||||
*/
|
|
||||||
getResult() {
|
|
||||||
return Utils.assign({}, this.parsedResult);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if parsed browser matches certain conditions
|
|
||||||
*
|
|
||||||
* @param {Object} 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 = Bowser.getParser(window.navigator.userAgent);
|
|
||||||
* if (browser.satisfies({chrome: '>118.01.1322' }))
|
|
||||||
* // or with os
|
|
||||||
* if (browser.satisfies({windows: { chrome: '>118.01.1322' } }))
|
|
||||||
* // or with platforms
|
|
||||||
* if (browser.satisfies({desktop: { chrome: '>118.01.1322' } }))
|
|
||||||
*/
|
|
||||||
satisfies(checkTree) {
|
|
||||||
const platformsAndOSes = {};
|
|
||||||
let platformsAndOSCounter = 0;
|
|
||||||
const browsers = {};
|
|
||||||
let browsersCounter = 0;
|
|
||||||
|
|
||||||
const allDefinitions = Object.keys(checkTree);
|
|
||||||
|
|
||||||
allDefinitions.forEach((key) => {
|
|
||||||
const currentDefinition = checkTree[key];
|
|
||||||
if (typeof currentDefinition === 'string') {
|
|
||||||
browsers[key] = currentDefinition;
|
|
||||||
browsersCounter += 1;
|
|
||||||
} else if (typeof currentDefinition === 'object') {
|
|
||||||
platformsAndOSes[key] = currentDefinition;
|
|
||||||
platformsAndOSCounter += 1;
|
|
||||||
}
|
|
||||||
});
|
|
||||||
|
|
||||||
if (platformsAndOSCounter > 0) {
|
|
||||||
const platformsAndOSNames = Object.keys(platformsAndOSes);
|
|
||||||
const OSMatchingDefinition = Utils.find(platformsAndOSNames, name => (this.isOS(name)));
|
|
||||||
|
|
||||||
if (OSMatchingDefinition) {
|
|
||||||
const osResult = this.satisfies(platformsAndOSes[OSMatchingDefinition]);
|
|
||||||
|
|
||||||
if (osResult !== void 0) {
|
|
||||||
return osResult;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
const platformMatchingDefinition = Utils.find(
|
|
||||||
platformsAndOSNames,
|
|
||||||
name => (this.isPlatform(name)),
|
|
||||||
);
|
|
||||||
if (platformMatchingDefinition) {
|
|
||||||
const platformResult = this.satisfies(platformsAndOSes[platformMatchingDefinition]);
|
|
||||||
|
|
||||||
if (platformResult !== void 0) {
|
|
||||||
return platformResult;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if (browsersCounter > 0) {
|
|
||||||
const browserNames = Object.keys(browsers);
|
|
||||||
const matchingDefinition = Utils.find(browserNames, name => (this.isBrowser(name, true)));
|
|
||||||
|
|
||||||
if (matchingDefinition !== void 0) {
|
|
||||||
return this.compareVersion(browsers[matchingDefinition]);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return 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, 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 expectedResults = [0];
|
|
||||||
let comparableVersion = version;
|
|
||||||
let isLoose = false;
|
|
||||||
|
|
||||||
const currentBrowserVersion = this.getBrowserVersion();
|
|
||||||
|
|
||||||
if (typeof currentBrowserVersion !== 'string') {
|
|
||||||
return void 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
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] === '~') {
|
|
||||||
isLoose = true;
|
|
||||||
comparableVersion = version.substr(1);
|
|
||||||
}
|
|
||||||
|
|
||||||
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, includingAlias = false) {
|
|
||||||
return this.isBrowser(anything, includingAlias) || this.isOS(anything)
|
|
||||||
|| this.isPlatform(anything);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Check if any of the given values satisfies this.is(anything)
|
|
||||||
* @param {String[]} anythings
|
|
||||||
* @returns {Boolean}
|
|
||||||
*/
|
|
||||||
some(anythings = []) {
|
|
||||||
return anythings.some(anything => this.is(anything));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
export default Parser;
|
|
||||||
1577
src/useragents.js
Normal file
1577
src/useragents.js
Normal file
File diff suppressed because it is too large
Load Diff
309
src/utils.js
309
src/utils.js
@ -1,309 +0,0 @@
|
|||||||
import { BROWSER_MAP, BROWSER_ALIASES_MAP } from './constants.js';
|
|
||||||
|
|
||||||
export default class Utils {
|
|
||||||
/**
|
|
||||||
* Get first matched item for a string
|
|
||||||
* @param {RegExp} regexp
|
|
||||||
* @param {String} ua
|
|
||||||
* @return {Array|{index: number, input: string}|*|boolean|string}
|
|
||||||
*/
|
|
||||||
static getFirstMatch(regexp, ua) {
|
|
||||||
const match = ua.match(regexp);
|
|
||||||
return (match && match.length > 0 && match[1]) || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Get second matched item for a string
|
|
||||||
* @param regexp
|
|
||||||
* @param {String} ua
|
|
||||||
* @return {Array|{index: number, input: string}|*|boolean|string}
|
|
||||||
*/
|
|
||||||
static getSecondMatch(regexp, ua) {
|
|
||||||
const match = ua.match(regexp);
|
|
||||||
return (match && match.length > 1 && match[2]) || '';
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Match a regexp and return a constant or undefined
|
|
||||||
* @param {RegExp} regexp
|
|
||||||
* @param {String} ua
|
|
||||||
* @param {*} _const Any const that will be returned if regexp matches the string
|
|
||||||
* @return {*}
|
|
||||||
*/
|
|
||||||
static matchAndReturnConst(regexp, ua, _const) {
|
|
||||||
if (regexp.test(ua)) {
|
|
||||||
return _const;
|
|
||||||
}
|
|
||||||
return void (0);
|
|
||||||
}
|
|
||||||
|
|
||||||
static getWindowsVersionName(version) {
|
|
||||||
switch (version) {
|
|
||||||
case 'NT': return 'NT';
|
|
||||||
case 'XP': return 'XP';
|
|
||||||
case 'NT 5.0': return '2000';
|
|
||||||
case 'NT 5.1': return 'XP';
|
|
||||||
case 'NT 5.2': return '2003';
|
|
||||||
case 'NT 6.0': return 'Vista';
|
|
||||||
case 'NT 6.1': return '7';
|
|
||||||
case 'NT 6.2': return '8';
|
|
||||||
case 'NT 6.3': return '8.1';
|
|
||||||
case 'NT 10.0': return '10';
|
|
||||||
default: return undefined;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 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
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* getVersionPrecision("1.10.3") // 3
|
|
||||||
*
|
|
||||||
* @param {string} version
|
|
||||||
* @return {number}
|
|
||||||
*/
|
|
||||||
static getVersionPrecision(version) {
|
|
||||||
return version.split('.').length;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Calculate browser version weight
|
|
||||||
*
|
|
||||||
* @example
|
|
||||||
* compareVersions('1.10.2.1', '1.8.2.1.90') // 1
|
|
||||||
* compareVersions('1.010.2.1', '1.09.2.1.90'); // 1
|
|
||||||
* compareVersions('1.10.2.1', '1.10.2.1'); // 0
|
|
||||||
* compareVersions('1.10.2.1', '1.0800.2'); // -1
|
|
||||||
* compareVersions('1.10.2.1', '1.10', true); // 0
|
|
||||||
*
|
|
||||||
* @param {String} versionA versions versions to compare
|
|
||||||
* @param {String} versionB versions versions to compare
|
|
||||||
* @param {boolean} [isLoose] enable loose comparison
|
|
||||||
* @return {Number} comparison result: -1 when versionA is lower,
|
|
||||||
* 1 when versionA is bigger, 0 when both equal
|
|
||||||
*/
|
|
||||||
/* eslint consistent-return: 1 */
|
|
||||||
static compareVersions(versionA, versionB, isLoose = false) {
|
|
||||||
// 1) get common precision for both versions, for example for "10.0" and "9" it should be 2
|
|
||||||
const versionAPrecision = Utils.getVersionPrecision(versionA);
|
|
||||||
const versionBPrecision = Utils.getVersionPrecision(versionB);
|
|
||||||
|
|
||||||
let precision = Math.max(versionAPrecision, versionBPrecision);
|
|
||||||
let lastPrecision = 0;
|
|
||||||
|
|
||||||
const chunks = Utils.map([versionA, versionB], (version) => {
|
|
||||||
const delta = precision - Utils.getVersionPrecision(version);
|
|
||||||
|
|
||||||
// 2) "9" -> "9.0" (for precision = 2)
|
|
||||||
const _version = version + new Array(delta + 1).join('.0');
|
|
||||||
|
|
||||||
// 3) "9.0" -> ["000000000"", "000000009"]
|
|
||||||
return Utils.map(_version.split('.'), chunk => new Array(20 - chunk.length).join('0') + chunk).reverse();
|
|
||||||
});
|
|
||||||
|
|
||||||
// adjust precision for loose comparison
|
|
||||||
if (isLoose) {
|
|
||||||
lastPrecision = precision - Math.min(versionAPrecision, versionBPrecision);
|
|
||||||
}
|
|
||||||
|
|
||||||
// iterate in reverse order by reversed chunks array
|
|
||||||
precision -= 1;
|
|
||||||
while (precision >= lastPrecision) {
|
|
||||||
// 4) compare: "000000009" > "000000010" = false (but "9" > "10" = true)
|
|
||||||
if (chunks[0][precision] > chunks[1][precision]) {
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (chunks[0][precision] === chunks[1][precision]) {
|
|
||||||
if (precision === lastPrecision) {
|
|
||||||
// all version chunks are same
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
precision -= 1;
|
|
||||||
} else if (chunks[0][precision] < chunks[1][precision]) {
|
|
||||||
return -1;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return undefined;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Array::map polyfill
|
|
||||||
*
|
|
||||||
* @param {Array} arr
|
|
||||||
* @param {Function} iterator
|
|
||||||
* @return {Array}
|
|
||||||
*/
|
|
||||||
static map(arr, iterator) {
|
|
||||||
const result = [];
|
|
||||||
let i;
|
|
||||||
if (Array.prototype.map) {
|
|
||||||
return Array.prototype.map.call(arr, iterator);
|
|
||||||
}
|
|
||||||
for (i = 0; i < arr.length; i += 1) {
|
|
||||||
result.push(iterator(arr[i]));
|
|
||||||
}
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 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] || '';
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@ -1,21 +0,0 @@
|
|||||||
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, 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}`);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
});
|
|
||||||
File diff suppressed because it is too large
Load Diff
151
test/test.js
Normal file
151
test/test.js
Normal file
@ -0,0 +1,151 @@
|
|||||||
|
/**
|
||||||
|
* Loop through all entries in our user agents object and test everything.
|
||||||
|
*
|
||||||
|
* @see src/useragents.js
|
||||||
|
* @author hannes.diercks@jimdo.com
|
||||||
|
*/
|
||||||
|
|
||||||
|
var g
|
||||||
|
, ua
|
||||||
|
, p
|
||||||
|
, assert = require('assert')
|
||||||
|
, browser = require('../src/bowser')
|
||||||
|
, allUserAgents = require('../src/useragents').useragents
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Get the length of an object.
|
||||||
|
* http://stackoverflow.com/questions/5223/length-of-javascript-object-ie-associative-array
|
||||||
|
*
|
||||||
|
* @param {Object} obj
|
||||||
|
* @return {Number}
|
||||||
|
*/
|
||||||
|
function objLength(obj) {
|
||||||
|
var size = 0
|
||||||
|
, key
|
||||||
|
for (key in obj) {
|
||||||
|
if (obj.hasOwnProperty(key)) size++
|
||||||
|
}
|
||||||
|
return size
|
||||||
|
}
|
||||||
|
|
||||||
|
function objKeys(obj) {
|
||||||
|
var keys = []
|
||||||
|
, key
|
||||||
|
for (key in obj) {
|
||||||
|
if (obj.hasOwnProperty(key)) {
|
||||||
|
keys.push(key)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
keys.sort();
|
||||||
|
return keys.join(', ')
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Groups */
|
||||||
|
for (g in allUserAgents) { (function(group, userAgents) {
|
||||||
|
describe(group, function() {
|
||||||
|
|
||||||
|
/* User Agents */
|
||||||
|
for (ua in userAgents) { (function(userAgent, expections) {
|
||||||
|
describe('user agent "' + userAgent + '"', function() {
|
||||||
|
|
||||||
|
expections.name = group
|
||||||
|
|
||||||
|
/* Get the result from bowser. */
|
||||||
|
var result = browser._detect(userAgent)
|
||||||
|
|
||||||
|
/* At first, check if the result has the correct length. */
|
||||||
|
it('should have ' + objLength(expections) + ' properties', function() {
|
||||||
|
assert.equal(objKeys(result), objKeys(expections))
|
||||||
|
})
|
||||||
|
|
||||||
|
/* Properties */
|
||||||
|
for (p in expections) { (function(property, value, resultValue) {
|
||||||
|
|
||||||
|
/* Now ensure correctness of every property. */
|
||||||
|
it('\'s Property "' + property + '" should be ' + value, function() {
|
||||||
|
assert.equal(resultValue, value)
|
||||||
|
})
|
||||||
|
|
||||||
|
})(p, expections[p], result[p])}
|
||||||
|
|
||||||
|
})
|
||||||
|
})(ua, userAgents[ua])}
|
||||||
|
|
||||||
|
})
|
||||||
|
})(g, allUserAgents[g])}
|
||||||
|
|
||||||
|
var comparisionsTasks = [
|
||||||
|
['9.0', '10', -1],
|
||||||
|
['11', '10', 1],
|
||||||
|
['1.10.2.1', '1.8.2.1.90', 1],
|
||||||
|
['1.010.2.1', '1.08.2.1.90', 1],
|
||||||
|
['1.10.2.1', '1.10.2.1', 0],
|
||||||
|
['1.10.2.1', '1.0800.2', -1],
|
||||||
|
['1.0.0-alpha', '1.0.0-alpha.1', -1],
|
||||||
|
['1.0.0-alpha.1', '1.0.0-alpha.beta', -1],
|
||||||
|
['1.0.0-alpha.beta', '1.0.0-beta', -1],
|
||||||
|
['1.0.0-beta', '1.0.0-beta.2', -1],
|
||||||
|
['1.0.0-beta.11', '1.0.0-rc.1', -1],
|
||||||
|
['1.0.0-rc.1', '1.0.0', -1]
|
||||||
|
];
|
||||||
|
|
||||||
|
describe('Browser versions comparision', function() {
|
||||||
|
for(g in comparisionsTasks) {
|
||||||
|
var task = comparisionsTasks[g],
|
||||||
|
version = task[0],
|
||||||
|
version2 = task[1],
|
||||||
|
matching = task[2] === 0 ? ' == ' : (task[2] > 0) ? ' > ' : ' < ';
|
||||||
|
it('version ' + version + ' should be' + matching + 'version ' + version2, function(){
|
||||||
|
assert.equal(browser.compareVersions([version, version2]), task[2]);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
describe('Unsupported browser check', function() {
|
||||||
|
|
||||||
|
before(function() {
|
||||||
|
this.ie10_6 = "Mozilla/5.0 (compatible; MSIE 10.6; Windows NT 6.1; Trident/5.0; InfoPath.2; SLCC1; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729; .NET CLR 2.0.50727) 3gpp-gba UNTRUSTED/1.0";
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should be passed by #isUnsupportedBrowser for IE10.6 and for IE10 miminal version specified', function() {
|
||||||
|
var unsupported = browser.isUnsupportedBrowser({msie: "10"}, this.ie10_6);
|
||||||
|
assert.equal(unsupported, false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should be passed by #isUnsupportedBrowser for IE10.6 and for IE10 miminal version specified in strict mode', function() {
|
||||||
|
var unsupported = browser.isUnsupportedBrowser({msie: "10"}, true, this.ie10_6);
|
||||||
|
assert.equal(unsupported, false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should NOT be passed by #isUnsupportedBrowser for IE10.6 and for IE10 miminal version specified in strict mode', function() {
|
||||||
|
var isUnsupported = browser.isUnsupportedBrowser({msie: "11"}, true, this.ie10_6);
|
||||||
|
assert.equal(isUnsupported, true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should NOT be passed by #check for IE10.6 and for IE11 miminal version specified', function() {
|
||||||
|
var supported = browser.check({msie: "11"}, this.ie10_6);
|
||||||
|
assert.equal(supported, false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should NOT be passed by #check for IE10.6 and for IE11 miminal version specified in strict mode', function() {
|
||||||
|
var supported = browser.check({msie: "11"}, true, this.ie10_6);
|
||||||
|
assert.equal(supported, false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should throw an error when minVersion map has a number, but not a string', function() {
|
||||||
|
assert.throws(() => {
|
||||||
|
browser.check({msie: 11}, this.ie10_6);
|
||||||
|
}, /Browser version in the minVersion map should be a string/);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should be passed by #check for IE10.6 when version was not specified', function() {
|
||||||
|
var supported = browser.check({}, this.ie10_6);
|
||||||
|
assert.equal(supported, true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it('should NOT be passed by #check for IE10.6 when version was not specified in strict mode', function() {
|
||||||
|
var supported = browser.check({}, true, this.ie10_6);
|
||||||
|
assert.equal(supported, false);
|
||||||
|
});
|
||||||
|
|
||||||
|
})
|
||||||
@ -1,18 +0,0 @@
|
|||||||
import test from 'ava';
|
|
||||||
import Bowser from '../../src/bowser';
|
|
||||||
import Parser from '../../src/parser';
|
|
||||||
|
|
||||||
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 browser = Bowser.getParser(UA);
|
|
||||||
|
|
||||||
test('Bowser`s constructor returns a Parser instance', (t) => {
|
|
||||||
t.truthy(browser instanceof Parser);
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Bowser`s constructor fails if UA is empty', (t) => {
|
|
||||||
t.throws(() => (Bowser.getParser()));
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Bowser.parse parses UA and returns result', (t) => {
|
|
||||||
t.deepEqual(Bowser.parse(UA), browser.getResult());
|
|
||||||
});
|
|
||||||
@ -1,15 +0,0 @@
|
|||||||
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, []);
|
|
||||||
});
|
|
||||||
@ -1,230 +0,0 @@
|
|||||||
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);
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.getUA returns a correct UA', (t) => {
|
|
||||||
t.is(parser.getUA(), UA);
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.test', (t) => {
|
|
||||||
t.truthy(parser.test(/Chrome/i));
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.parseBrowser is being called when the Parser.getBrowser() is called', (t) => {
|
|
||||||
const spy = sinon.spy(parser, 'parseBrowser');
|
|
||||||
const b = parser.getBrowser();
|
|
||||||
t.truthy(spy.called);
|
|
||||||
t.is(b.name, 'Opera');
|
|
||||||
t.is(b.version, '43.0.2442.1165');
|
|
||||||
parser.parseBrowser.restore();
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.getBrowserName returns a correct result', (t) => {
|
|
||||||
t.is(parser.getBrowserName(), 'Opera');
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.getBrowserVersion returns a correct result', (t) => {
|
|
||||||
t.is(parser.getBrowserVersion(), '43.0.2442.1165');
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.parseOS is being called when getOS() called', (t) => {
|
|
||||||
const spy = sinon.spy(parser, 'parseOS');
|
|
||||||
parser.getOS();
|
|
||||||
t.truthy(spy.called);
|
|
||||||
parser.parseOS.restore();
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.getOSName gives a name of the browser', (t) => {
|
|
||||||
t.is(parser.getOSName(), 'macOS');
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.getOSName gives a lower-cased name of the browser', (t) => {
|
|
||||||
t.is(parser.getOSName(true), 'macos');
|
|
||||||
});
|
|
||||||
|
|
||||||
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(), {});
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.satisfies should make simple comparisons', (t) => {
|
|
||||||
// also covers Parser.compareVersion() method
|
|
||||||
t.is(parser.satisfies({ opera: '>42' }), true);
|
|
||||||
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);
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.satisfies should make complex comparison', (t) => {
|
|
||||||
t.is(parser.satisfies({
|
|
||||||
macos: {
|
|
||||||
safari: '>11',
|
|
||||||
},
|
|
||||||
ios: {
|
|
||||||
safari: '>10',
|
|
||||||
},
|
|
||||||
opera: '>42',
|
|
||||||
}), true);
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.satisfies should respect platform and OS specific declarations', (t) => {
|
|
||||||
t.is(parser.satisfies({
|
|
||||||
macos: {
|
|
||||||
opera: '>45',
|
|
||||||
},
|
|
||||||
opera: '>42',
|
|
||||||
}), false);
|
|
||||||
|
|
||||||
t.is(parser.satisfies({
|
|
||||||
desktop: {
|
|
||||||
opera: '>45',
|
|
||||||
},
|
|
||||||
opera: '>42',
|
|
||||||
}), false);
|
|
||||||
|
|
||||||
t.is(parser.satisfies({
|
|
||||||
macos: {
|
|
||||||
opera: '>45',
|
|
||||||
},
|
|
||||||
desktop: {
|
|
||||||
opera: '>42',
|
|
||||||
},
|
|
||||||
opera: '>42',
|
|
||||||
}), false);
|
|
||||||
|
|
||||||
t.is(parser.satisfies({
|
|
||||||
macos: {
|
|
||||||
chrome: '>45',
|
|
||||||
},
|
|
||||||
desktop: {
|
|
||||||
chrome: '>42',
|
|
||||||
},
|
|
||||||
firefox: '>42',
|
|
||||||
}), void 0);
|
|
||||||
});
|
|
||||||
|
|
||||||
test('Parser.satisfies for versionless UA strings', (t) => {
|
|
||||||
const _parser = new Parser('Mozilla/5.0 (iPhone; CPU iPhone OS 11_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15G77 [FBAN/FBIOS;FBDV/iPhone7,2;FBMD/iPhone;FBSN/iOS;FBSV/11.4.1;FBSS/2;FBCR/vfnl;FBID/phone;FBLC/nl_NL;FBOP/5;FBRV/0]');
|
|
||||||
|
|
||||||
t.is(_parser.satisfies({
|
|
||||||
safari: '>9',
|
|
||||||
}), 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);
|
|
||||||
t.is(parser.some(['chrome', 'firefox']), false);
|
|
||||||
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);
|
|
||||||
});
|
|
||||||
@ -1,140 +0,0 @@
|
|||||||
import test from 'ava';
|
|
||||||
import {
|
|
||||||
getFirstMatch,
|
|
||||||
getSecondMatch,
|
|
||||||
matchAndReturnConst,
|
|
||||||
getWindowsVersionName,
|
|
||||||
getMacOSVersionName,
|
|
||||||
getAndroidVersionName,
|
|
||||||
getVersionPrecision,
|
|
||||||
compareVersions,
|
|
||||||
map,
|
|
||||||
find,
|
|
||||||
assign,
|
|
||||||
getBrowserAlias,
|
|
||||||
getBrowserTypeByAlias
|
|
||||||
} from '../../src/utils';
|
|
||||||
|
|
||||||
test('getFirstMatch', (t) => {
|
|
||||||
const matchedVersion = getFirstMatch(/version\/(\S+)/i, 'Chrome Version/11.11.11');
|
|
||||||
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],
|
|
||||||
['11', '10', 1],
|
|
||||||
['1.10.2.1', '1.8.2.1.90', 1],
|
|
||||||
['1.010.2.1', '1.08.2.1.90', 1],
|
|
||||||
['1.10.2.1', '1.10.2.1', 0],
|
|
||||||
['1.10.2.1', '1.10.2', 0, true],
|
|
||||||
['1.10.2.1', '1.10', 0, true],
|
|
||||||
['1.10.2.1', '1', 0, true],
|
|
||||||
['1.10.2.1', '1.0800.2', -1],
|
|
||||||
['1.0.0-alpha', '1.0.0-alpha.1', -1],
|
|
||||||
['1.0.0-alpha.1', '1.0.0-alpha.beta', -1],
|
|
||||||
['1.0.0-alpha.beta', '1.0.0-beta', -1],
|
|
||||||
['1.0.0-beta', '1.0.0-beta.2', -1],
|
|
||||||
['1.0.0-beta.11', '1.0.0-rc.1', -1],
|
|
||||||
['1.0.0-rc.1', '1.0.0', -1],
|
|
||||||
];
|
|
||||||
|
|
||||||
comparisionsTasks.forEach((testingParams) => {
|
|
||||||
const versionA = testingParams[0];
|
|
||||||
const versionB = testingParams[1];
|
|
||||||
const result = testingParams[2];
|
|
||||||
const isLoose = testingParams.length > 3 ? testingParams[3] : false;
|
|
||||||
let matching = isLoose ? '~' : ' == ';
|
|
||||||
|
|
||||||
if (result > 0) {
|
|
||||||
matching = ' > ';
|
|
||||||
} else if (result < 0) {
|
|
||||||
matching = ' < ';
|
|
||||||
}
|
|
||||||
|
|
||||||
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), '');
|
|
||||||
});
|
|
||||||
|
|
||||||
106
typings.d.ts
vendored
Normal file
106
typings.d.ts
vendored
Normal file
@ -0,0 +1,106 @@
|
|||||||
|
// Type definitions for Bowser 1.x
|
||||||
|
// Project: https://github.com/lancedikson/bowser
|
||||||
|
// Definitions by: Paulo Cesar <https://github.com/pocesar>
|
||||||
|
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
||||||
|
|
||||||
|
declare const bowser: bowser.IBowser;
|
||||||
|
export = bowser;
|
||||||
|
export as namespace bowser;
|
||||||
|
|
||||||
|
declare namespace bowser {
|
||||||
|
|
||||||
|
export interface IBowserOS {
|
||||||
|
mac: boolean;
|
||||||
|
/**other than Windows Phone */
|
||||||
|
windows: boolean;
|
||||||
|
windowsphone: boolean;
|
||||||
|
/**other than android, chromeos, webos, tizen, and sailfish */
|
||||||
|
linux: boolean;
|
||||||
|
chromeos: boolean;
|
||||||
|
android: boolean;
|
||||||
|
/** also sets one of iphone/ipad/ipod */
|
||||||
|
ios: boolean;
|
||||||
|
blackberry: boolean;
|
||||||
|
firefoxos: boolean;
|
||||||
|
/** may also set touchpad */
|
||||||
|
webos: boolean;
|
||||||
|
bada: boolean;
|
||||||
|
tizen: boolean;
|
||||||
|
sailfish: boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IBowserVersions {
|
||||||
|
chrome: boolean;
|
||||||
|
chromium: boolean;
|
||||||
|
firefox: boolean;
|
||||||
|
msie: boolean;
|
||||||
|
msedge: boolean;
|
||||||
|
safari: boolean;
|
||||||
|
android: boolean;
|
||||||
|
ios: boolean;
|
||||||
|
opera: boolean;
|
||||||
|
phantom: boolean;
|
||||||
|
blackberry: boolean;
|
||||||
|
webos: boolean;
|
||||||
|
silk: boolean;
|
||||||
|
bada: boolean;
|
||||||
|
tizen: boolean;
|
||||||
|
seamonkey: boolean;
|
||||||
|
sailfish: boolean;
|
||||||
|
ucbrowser: boolean;
|
||||||
|
qupzilla: boolean;
|
||||||
|
vivaldi: boolean;
|
||||||
|
sleipnir: boolean;
|
||||||
|
kMeleon: boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IBowserEngines {
|
||||||
|
/** IE <= 11 */
|
||||||
|
msie: boolean;
|
||||||
|
/**Chrome 0-27, Android <4.4, iOs, BB, etc. */
|
||||||
|
webkit: boolean;
|
||||||
|
/**Chrome >=28, Android >=4.4, Opera, etc. */
|
||||||
|
blink: boolean;
|
||||||
|
/**Firefox, etc. */
|
||||||
|
gecko: boolean;
|
||||||
|
/** IE > 11 */
|
||||||
|
msedge: boolean;
|
||||||
|
/** If a tablet device is detected, the flag tablet is set instead of mobile. */
|
||||||
|
tablet: boolean;
|
||||||
|
/** All detected mobile OSes are additionally flagged mobile, unless it's a tablet */
|
||||||
|
mobile: boolean;
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IBowserGrade {
|
||||||
|
/** Grade A browser */
|
||||||
|
a: boolean;
|
||||||
|
/** Grade C browser */
|
||||||
|
c: boolean;
|
||||||
|
/** Grade X browser */
|
||||||
|
x: boolean;
|
||||||
|
/**A human readable name for this browser. E.g. 'Chrome', '' */
|
||||||
|
name: string;
|
||||||
|
/**Version number for the browser. E.g. '32.0' */
|
||||||
|
version: string|number;
|
||||||
|
osversion: string|number;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IBowserDetection extends IBowserGrade, IBowserEngines, IBowserOS, IBowserVersions { }
|
||||||
|
|
||||||
|
export interface IBowserMinVersions {
|
||||||
|
// { msie: "11", "firefox": "4" }
|
||||||
|
[index: string]: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface IBowser extends IBowserDetection {
|
||||||
|
(): IBowserDetection;
|
||||||
|
test(browserList: string[]): boolean;
|
||||||
|
_detect(ua: string): IBowser;
|
||||||
|
detect(ua: string): IBowser;
|
||||||
|
compareVersions(versions: string[]): number;
|
||||||
|
check(minVersions: IBowserMinVersions, strictMode?: boolean|string, ua?: string): Boolean;
|
||||||
|
isUnsupportedBrowser(minVersions: IBowserMinVersions, strictMode?: boolean|string, ua?: string): boolean;
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@ -1,43 +0,0 @@
|
|||||||
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'],
|
|
||||||
es5: './src/bowser.js',
|
|
||||||
}, // string | object | array
|
|
||||||
// defaults to ./src
|
|
||||||
// Here the application starts executing
|
|
||||||
// and webpack starts bundling
|
|
||||||
output: {
|
|
||||||
// options related to how webpack emits results
|
|
||||||
path: path.resolve(__dirname, './'), // string
|
|
||||||
// the target directory for all output files
|
|
||||||
// must be an absolute path (use the Node.js path module)
|
|
||||||
filename: '[name].js', // string
|
|
||||||
// the filename template for entry chunks
|
|
||||||
library: 'bowser',
|
|
||||||
libraryTarget: 'umd', // universal module definition
|
|
||||||
// the type of the exported library
|
|
||||||
globalObject: 'this',
|
|
||||||
},
|
|
||||||
module: {
|
|
||||||
// configuration regarding modules
|
|
||||||
rules: [
|
|
||||||
// rules for modules (configure loaders, parser options, etc.)
|
|
||||||
{
|
|
||||||
test: /\.js$/,
|
|
||||||
exclude: /(node_modules|bower_components)/,
|
|
||||||
use: {
|
|
||||||
loader: 'babel-loader',
|
|
||||||
},
|
|
||||||
},
|
|
||||||
],
|
|
||||||
},
|
|
||||||
};
|
|
||||||
Loading…
Reference in New Issue
Block a user