getUserAgent.mjs

  1. import { UAParser } from 'ua-parser-js'
  2. import get from 'lodash-es/get.js'
  3. import isstr from './isstr.mjs'
  4. import getGlobal from './getGlobal.mjs'
  7. function getUAParser() {
  8.     let g = getGlobal()
  9.     let x = UAParser || g.UAParser
  10.     return x
  11. }
  14. /**
  15.  * 取得使用者瀏覽器資訊，後端nodejs環境使用需提供user agent字串
  16.  *
  17.  * Unit Test: {@link https://github.com/yuda-lyu/wsemi/blob/master/test/getUserAgent.test.mjs Github}
  18.  * @memberOf wsemi
  19.  * @param {String} [v=null] 輸入user agent字串，預設null
  20.  * @returns {Object} 回傳使用者瀏覽器資訊物件
  21.  * @example
  22.  *
  23.  * let ua = 'Mozilla/5.0 (compatible; Konqueror/4.1; OpenBSD) KHTML/4.1.4 (like Gecko)'
  24.  * console.log(getUserAgent(ua))
  25.  * // => {
  26.  *     browsername: 'Konqueror',
  27.  *     browserversion: '4.1',
  28.  *     cpuarchitecture: '',
  29.  *     devicetype: '',
  30.  *     engineinfor: 'KHTML4.1.4',
  31.  *     platform: 'OpenBSDundefined'
  32.  * }
  33.  *
  34.  */
  35. function getUserAgent(v = null) {
  37.     //parser
  38.     let parser
  39.     let Upr = getUAParser()
  40.     if (isstr(v)) {
  41.         parser = new Upr(v)
  42.     }
  43.     else {
  44.         parser = new Upr()
  45.     }
  47.     let oua = parser.getResult()
  48.     return {
  49.         browsername: oua.browser.name,
  50.         browserversion: oua.browser.version,
  51.         engineinfor: oua.engine.name + oua.engine.version,
  52.         platform: oua.os.name + oua.os.version,
  53.         devicetype: get(oua.device, 'type', ''),
  54.         cpuarchitecture: get(oua.cpu, 'architecture', '')
  55.     }
  56. }
  59. export default getUserAgent