78 lines
1.8 KiB
JavaScript
78 lines
1.8 KiB
JavaScript
/*!
|
|
* 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;
|