File Explorer

1/*!2 * Bowser - a browser detector3 * https://github.com/bowser-js/bowser4 * MIT License | (c) Dustin Diaz 2012-20155 * MIT License | (c) Denis Demchenko 2015-20196 */7import Parser from './parser.js';8import {9  BROWSER_MAP,10  ENGINE_MAP,11  OS_MAP,12  PLATFORMS_MAP,13} from './constants.js';14 15/**16 * Bowser class.17 * Keep it simple as much as it can be.18 * It's supposed to work with collections of {@link Parser} instances19 * rather then solve one-instance problems.20 * All the one-instance stuff is located in Parser class.21 *22 * @class23 * @classdesc Bowser is a static object, that provides an API to the Parsers24 * @hideconstructor25 */26class Bowser {27  /**28   * Creates a {@link Parser} instance29   *30   * @param {String} UA UserAgent string31   * @param {Boolean|Object} [skipParsingOrHints=false] Either a boolean to skip parsing,32   * or a ClientHints object (navigator.userAgentData)33   * @param {Object} [clientHints] User-Agent Client Hints data (navigator.userAgentData)34   * @returns {Parser}35   * @throws {Error} when UA is not a String36   *37   * @example38   * const parser = Bowser.getParser(window.navigator.userAgent);39   * const result = parser.getResult();40   *41   * @example42   * // With User-Agent Client Hints43   * const parser = Bowser.getParser(44   *   window.navigator.userAgent,45   *   window.navigator.userAgentData46   * );47   */48  static getParser(UA, skipParsingOrHints = false, clientHints = null) {49    if (typeof UA !== 'string') {50      throw new Error('UserAgent should be a string');51    }52    return new Parser(UA, skipParsingOrHints, clientHints);53  }54 55  /**56   * Creates a {@link Parser} instance and runs {@link Parser.getResult} immediately57   *58   * @param {String} UA UserAgent string59   * @param {Object} [clientHints] User-Agent Client Hints data (navigator.userAgentData)60   * @return {ParsedResult}61   *62   * @example63   * const result = Bowser.parse(window.navigator.userAgent);64   *65   * @example66   * // With User-Agent Client Hints67   * const result = Bowser.parse(68   *   window.navigator.userAgent,69   *   window.navigator.userAgentData70   * );71   */72  static parse(UA, clientHints = null) {73    return (new Parser(UA, clientHints)).getResult();74  }75 76  static get BROWSER_MAP() {77    return BROWSER_MAP;78  }79 80  static get ENGINE_MAP() {81    return ENGINE_MAP;82  }83 84  static get OS_MAP() {85    return OS_MAP;86  }87 88  static get PLATFORMS_MAP() {89    return PLATFORMS_MAP;90  }91}92 93export default Bowser;94