Bowser class. Keep it simple as much as it can be. It's supposed to work with collections of Parser instances rather then solve one-instance problems. -All the one-instance stuff is located in Parser class.
Creates a module:parser:Parser instance
-Creates a module:parser:Parser instance
+const bowser = new Bowser(window.navigator.userAgent);
-bowser.getResult()| Name | - - -Type | - - -Attributes | - - - -Default | - - -Description | -
|---|---|---|---|---|
UA |
-
-
- - - -String - - - - | - - -- - - - - - | - - - -- - | - - -UserAgent string |
-
skipParsing |
-
-
- - - -Boolean - - - - | - - -
-
- <optional> - - - - - - |
-
-
-
-
-
- false
-
- |
-
-
- same as skipParsing for Parser |
-
when UA is not a String
-Creates a Parser instance and runs Parser.getResult immediately
-| Name | - - -Type | - - - - - -Description | -
|---|---|---|
UA |
-
-
- - - | - - - - - -- |
| Name | + + +Type | + + +Attributes | + + + +Default | + + +Description | +
|---|---|---|---|---|
UA |
+
+
+ + + +String + + + + | + + ++ + + + + + | + + + ++ + | + + +UserAgent string |
+
skipParsing |
+
+
+ + + +Boolean + + + + | + + +
+
+ <optional> + + + + + + |
+
+
+
+
+
+ false
+
+ |
+
+
+ same as skipParsing for Parser |
+
when UA is not a String
+Creates a Parser instance and runs Parser.getResult immediately
+| Name | + + +Type | + + + + + +Description | +
|---|---|---|
UA |
+
+
+ + + | + + + + + ++ |
The main class that arranges the whole parsing process.
Create instance of Parser
-| Name | - - -Type | - - -Attributes | - - - -Default | - - -Description | -||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
UA |
-
-
- - - -String - - - - | - - -- - - - - - | - - - -- - | - - -User-Agent string |
- ||||||||||||||
skipParsing |
-
-
- - - -Boolean - - - - | - - -
-
- <optional> - - - - - - |
-
-
-
-
-
- false
-
- |
-
-
+
+
+
+
+
+
| Name | + + +Type | + + +Attributes | + + + +Default | + + +Description | +
|---|---|---|---|---|
UA |
+
+
+ + + +String + + + + | + + ++ + + + + + | + + + ++ + | + + +User-Agent string |
+
skipParsing |
+
+
+ + + +Boolean + + + + | + + +
+
+ <optional> + + + + + + |
+
+
+
+
+
+ false
+
+ |
+
+
parser can skip parsing in purpose of performance improvements if you need to make a more particular parsing -like Parser#parseBrowser or Parser#parsePlatform |
-
Get parsed browser object
-Get browser's name
-Browser's name or an empty string
-Get browser's version
-version of browser
-Get parsed engine
-Get OS
-Get parsed browser object
+Get browser's name
+Browser's name or an empty string
+Get browser's version
+version of browser
+Get parsed engine
+Get OS
+this.getOS();
{
name: 'macOS',
version: '10.11.12'
-}Get OS name
-| Name | - - -Type | - - -Attributes | - - - - -Description | -
|---|---|---|---|
toLowerCase |
-
-
- - - -Boolean - - - - | - - -
-
- <optional> - - - - - - |
-
-
-
-
- return lower-cased value |
-
name of the OS — macOS, Windows, Linux, etc.
-Get OS version
-full version with dots ('10.11.12', '5.6', etc)
-Get parsed platform
-Get platform name
-| Name | - - -Type | - - -Attributes | - - - -Default | - - -Description | -
|---|---|---|---|---|
toLowerCase |
-
-
- - - -Boolean - - - - | - - -
-
- <optional> - - - - - - |
-
-
-
-
-
- false
-
- |
-
-
- - |
Get parsed result
-Get UserAgent string of current Parser instance
-User-Agent String of the current
Get OS name
+| Name | + + +Type | + + +Attributes | + + + + +Description | +
|---|---|---|---|
toLowerCase |
+
+
+ + + +Boolean + + + + | + + +
+
+ <optional> + + + + + + |
+
+
+
+
+ return lower-cased value |
+
name of the OS — macOS, Windows, Linux, etc.
+Get OS version
+full version with dots ('10.11.12', '5.6', etc)
+Get parsed platform
+Get platform name
+| Name | + + +Type | + + +Attributes | + + + +Default | + + +Description | +
|---|---|---|---|---|
toLowerCase |
+
+
+ + + +Boolean + + + + | + + +
+
+ <optional> + + + + + + |
+
+
+
+
+
+ false
+
+ |
+
+
+ + |
Get parsed result
+Get UserAgent string of current Parser instance
+User-Agent String of the current
Is anything? Check if the browser is called "anything", -the OS called "anything" or the platform called "anything"
-| Name | - - -Type | - - - - - -Description | -
|---|---|---|
anything |
-
-
- - - -String - - - - | - - - - - -- |
Parse full information about the browser
-Get parsed browser object
-Get parsed platform
-Parse OS and save it to this.parsedResult.os
-Get parsed platform
-Check if parsed browser matches certain conditions
-| Name | + + +Type | + + + + + +Description | +
|---|---|---|
anything |
+
+
+ + + +String + + + + | + + + + + ++ |
Parse full information about the browser
+Get parsed browser object
+Get parsed platform
+Parse OS and save it to this.parsedResult.os
+Get parsed platform
+Check if parsed browser matches certain conditions
+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' } }))| Name | - - -Type | - - - - - -Description | -|||||
|---|---|---|---|---|---|---|---|
checkTree |
-
-
- - - -Object - - - - | - - - - - +if (browser.check({desktop: { chrome: '>118.01.1322' } })) + + + + +
| Name | + + +Type | + + + + + +Description | +
|---|---|---|
checkTree |
+
+
+ + + +Object + + + + | + + + + +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 |
-
Whether the browser satisfies the set conditions or not.
-Returns undefined when the browser is no described in the checkTree object.
Check if any of the given values satifies this.is(anything)
-| Name | - - -Type | - - - - - -Description | -
|---|---|---|
anythings |
-
-
- - - -Array.<String> - - - - | - - - - - -- |
Test a UA string for a regexp
-| Name | - - -Type | - - - - - -Description | -
|---|---|---|
regex |
-
-
- - - -RegExp - - - - | - - - - - -- |
undefined when the browser is no described in the checkTree object.
+
+
+
+
+Check if any of the given values satifies this.is(anything)
+| Name | + + +Type | + + + + + +Description | +
|---|---|---|
anythings |
+
+
+ + + +Array.<String> + + + + | + + + + + ++ |
Test a UA string for a regexp
+| Name | + + +Type | + + + + + +Description | +
|---|---|---|
regex |
+
+
+ + + +RegExp + + + + | + + + + + ++ |
/*!
* Bowser - a browser detector
* https://github.com/lancedikson/bowser
@@ -84,22 +88,26 @@ class Bowser {
}
export default Bowser;
-| Name | - - -Type | - - - - - -Description | -|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
browser |
-
-
- - - -Object - - - - | - - - - - -
- Properties- -
|
- |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
os |
-
-
- - - -Object - - - - | - - - - - -
- Properties- -
|
- |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
platform |
-
-
- - - -Object - - - - | - - - - - -
- Properties- -
- - - - - - +like "iPhone" or "Kindle Fire HD 7"
+ |
+ |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
engine |
+
+
+ + + +Object + + + + | + + + + + +
+ Properties+ +
|
+
A Browser detector. Because sometimes, there is no other way, and not even good modern browsers always provide good feature detection mechanisms.
-
Licensed as MIT. All rights not explicitly granted in the MIT license are reserved. See the included LICENSE file for more details.
+import browserParsersList from './parser-browsers';
import osParsersList from './parser-os';
import platformParsersList from './parser-platforms';
@@ -438,6 +442,12 @@ class Parser {
let comparableVersion = version;
let isLoose = false;
+ const currentBrowserVersion = this.getBrowserVersion();
+
+ if (typeof currentBrowserVersion !== 'string') {
+ return void 0;
+ }
+
if (version[0] === '>') {
expectedResult = 1;
comparableVersion = version.substr(1);
@@ -451,7 +461,7 @@ class Parser {
comparableVersion = version.substr(1);
}
- return compareVersions(this.getBrowserVersion(), comparableVersion, isLoose) === expectedResult;
+ return compareVersions(currentBrowserVersion, comparableVersion, isLoose) === expectedResult;
}
isOS(osName) {
@@ -483,22 +493,26 @@ class Parser {
}
export default Parser;
-class Utils {
/**
* Get first matched item for a string
@@ -149,15 +153,18 @@
// 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 (chunks[0][precision] === chunks[1][precision]) {
if (precision === lastPrecision) {
// all version chunks are same
return 0;
}
- } else {
+
+ precision -= 1;
+ } else if (chunks[0][precision] < chunks[1][precision]) {
return -1;
}
- precision -= 1;
}
}
@@ -182,22 +189,26 @@
}
module.exports = Utils;
-