@naturalcycles/js-lib 15.86.0 → 15.86.2

package/dist/error/error.util.js

@@ -174,24 +174,49 @@ export function _errorSnippet(err, opt = {}) {
             .join(': ');
     }
 }
+// These duck-typing checks read properties of an arbitrary object, which may invoke its
+// property getters, which may throw (e.g a stateful getter, a Proxy trap).
+// A type guard should never throw - an object whose properties cannot even be read safely
+// is, by definition, not a well-behaved Error-like - hence try/catch returning false.
+// try/catch is free in V8 unless it actually catches, so there's no performance penalty.
 export function _isBackendErrorResponseObject(o) {
-    return _isErrorObject(o?.error);
+    try {
+        return _isErrorObject(o?.error);
+    }
+    catch {
+        return false;
+    }
 }
 export function _isHttpRequestErrorObject(o) {
-    return !!o && o.name === 'HttpRequestError' && typeof o.data?.requestUrl === 'string';
+    try {
+        return !!o && o.name === 'HttpRequestError' && typeof o.data?.requestUrl === 'string';
+    }
+    catch {
+        return false;
+    }
 }
 /**
  * Note: any instance of AppError is also automatically an ErrorObject
  */
 export function _isErrorObject(o) {
-    return (!!o &&
-        typeof o === 'object' &&
-        typeof o.name === 'string' &&
-        typeof o.message === 'string' &&
-        typeof o.data === 'object');
+    try {
+        return (!!o &&
+            typeof o === 'object' &&
+            typeof o.name === 'string' &&
+            typeof o.message === 'string' &&
+            typeof o.data === 'object');
+    }
+    catch {
+        return false;
+    }
 }
 export function _isErrorLike(o) {
-    return !!o && typeof o === 'object' && typeof o.name === 'string' && typeof o.message === 'string';
+    try {
+        return (!!o && typeof o === 'object' && typeof o.name === 'string' && typeof o.message === 'string');
+    }
+    catch {
+        return false;
+    }
 }
 /**
  * Convenience function to safely add properties to Error's `data` object

package/dist/ua/ua.d.ts

@@ -1,8 +1,47 @@
 /// <reference lib="dom" preserve="true" />
 export type UADeviceType = 'console' | 'mobile' | 'tablet' | 'smarttv' | 'wearable' | 'embedded';
+/**
+ * Popular OS names as produced by the parser, for convenient comparisons
+ * (`os.name === UAOSName.iOS`) without magic strings.
+ *
+ * Not exhaustive - the parser emits many more names; compare against a string for the rest.
+ */
+export declare enum UAOSName {
+    iOS = "iOS",
+    Android = "Android",
+    MacOS = "Mac OS",
+    Windows = "Windows",
+    Linux = "Linux",
+    ChromiumOS = "Chromium OS",
+    WatchOS = "watchOS"
+}
+/**
+ * Popular browser names as produced by the parser, for convenient comparisons
+ * (`browser.name === UABrowserName.Safari`) without magic strings.
+ *
+ * Not exhaustive - the parser emits many more names; compare against a string for the rest.
+ */
+export declare enum UABrowserName {
+    Chrome = "Chrome",
+    ChromeWebView = "Chrome WebView",
+    ChromeHeadless = "Chrome Headless",
+    Safari = "Safari",
+    MobileSafari = "Mobile Safari",
+    Firefox = "Firefox",
+    Edge = "Edge",
+    Opera = "Opera",
+    SamsungInternet = "Samsung Internet",
+    Facebook = "Facebook",
+    Instagram = "Instagram",
+    /**
+     * Bare WebKit UA without a Safari token, typically an iOS in-app webview (e.g. WKWebView).
+     */
+    WebKit = "WebKit"
+}
 export interface UABrowser {
     /**
      * E.g Chrome, Edge, Firefox, Safari, Mobile Safari, Opera, IE, UCBrowser, WeChat, ...
+     * Popular values are available as `UABrowserName`.
      */
     name: string | undefined;
     version: string | undefined;
@@ -39,6 +78,7 @@ export interface UAEngine {
 export interface UAOS {
     /**
      * E.g Windows, iOS, Mac OS, Android, Linux, Chromium OS, ...
+     * Popular values are available as `UAOSName`.
      */
     name: string | undefined;
     version: string | undefined;
@@ -88,6 +128,7 @@ export interface UAParserExtensions {
  * (with client-hints-based refinements, e.g. Brave and iPadOS detection).
  */
 export declare function parseUserAgent(userAgent?: string, extensions?: UAParserExtensions): UAResult;
+export declare function uaParser(userAgent?: string, extensions?: UAParserExtensions): UAParser;
 /**
  * User-Agent parser.
  *
@@ -97,11 +138,13 @@ export declare function parseUserAgent(userAgent?: string, extensions?: UAParser
  */
 export declare class UAParser {
     constructor(ua?: string, extensions?: UAParserExtensions);
-    constructor(extensions: UAParserExtensions);
     private ua;
     private readonly nav;
     private readonly rgxMap;
     private readonly isSelfNav;
+    private cachedBrowser?;
+    private cachedOs?;
+    private cachedDevice?;
     getBrowser(): UABrowser;
     getCPU(): UACpu;
     getDevice(): UADevice;
@@ -110,4 +153,31 @@ export declare class UAParser {
     getResult(): UAResult;
     getUA(): string;
     setUA(ua: string | undefined): this;
+    /**
+     * True if the OS is iOS.
+     * Note: desktop-mode iPads send a Mac-like UA and are not detected as iOS
+     * (except when parsing the browser's own UA, where client-hints refinements apply).
+     */
+    isIos(): boolean;
+    isAndroid(): boolean;
+    isMacOs(): boolean;
+    isWindows(): boolean;
+    /**
+     * True for 'Chrome', 'Chrome WebView' and 'Chrome Headless' (not for Chromium).
+     */
+    isChrome(): boolean;
+    /**
+     * True for 'Safari' and 'Mobile Safari' (not for bare-WebKit iOS in-app webviews).
+     */
+    isSafari(): boolean;
+    isFirefox(): boolean;
+    isEdge(): boolean;
+    /**
+     * True if the device type is 'mobile' (phones; tablets are 'tablet' - see isTablet).
+     */
+    isMobile(): boolean;
+    isTablet(): boolean;
+    private browser;
+    private os;
+    private device;
 }

package/dist/ua/ua.js

@@ -10,6 +10,46 @@
 // Detects Browser, Engine, OS, CPU and Device type/model from a User-Agent string.
 // Supports browser & Node.js environments.
 /// <reference lib="dom" preserve="true" />
+/**
+ * Popular OS names as produced by the parser, for convenient comparisons
+ * (`os.name === UAOSName.iOS`) without magic strings.
+ *
+ * Not exhaustive - the parser emits many more names; compare against a string for the rest.
+ */
+export var UAOSName;
+(function (UAOSName) {
+    UAOSName["iOS"] = "iOS";
+    UAOSName["Android"] = "Android";
+    UAOSName["MacOS"] = "Mac OS";
+    UAOSName["Windows"] = "Windows";
+    UAOSName["Linux"] = "Linux";
+    UAOSName["ChromiumOS"] = "Chromium OS";
+    UAOSName["WatchOS"] = "watchOS";
+})(UAOSName || (UAOSName = {}));
+/**
+ * Popular browser names as produced by the parser, for convenient comparisons
+ * (`browser.name === UABrowserName.Safari`) without magic strings.
+ *
+ * Not exhaustive - the parser emits many more names; compare against a string for the rest.
+ */
+export var UABrowserName;
+(function (UABrowserName) {
+    UABrowserName["Chrome"] = "Chrome";
+    UABrowserName["ChromeWebView"] = "Chrome WebView";
+    UABrowserName["ChromeHeadless"] = "Chrome Headless";
+    UABrowserName["Safari"] = "Safari";
+    UABrowserName["MobileSafari"] = "Mobile Safari";
+    UABrowserName["Firefox"] = "Firefox";
+    UABrowserName["Edge"] = "Edge";
+    UABrowserName["Opera"] = "Opera";
+    UABrowserName["SamsungInternet"] = "Samsung Internet";
+    UABrowserName["Facebook"] = "Facebook";
+    UABrowserName["Instagram"] = "Instagram";
+    /**
+     * Bare WebKit UA without a Safari token, typically an iOS in-app webview (e.g. WKWebView).
+     */
+    UABrowserName["WebKit"] = "WebKit";
+})(UABrowserName || (UABrowserName = {}));
 /**
  * Parses the given User-Agent string into browser, engine, os, device and cpu information.
  *
@@ -19,6 +59,9 @@
 export function parseUserAgent(userAgent, extensions) {
     return new UAParser(userAgent, extensions).getResult();
 }
+export function uaParser(userAgent, extensions) {
+    return new UAParser(userAgent, extensions);
+}
 /**
  * User-Agent parser.
  *
@@ -28,10 +71,6 @@ export function parseUserAgent(userAgent, extensions) {
  */
 export class UAParser {
     constructor(ua, extensions) {
-        if (typeof ua === 'object' && ua !== null) {
-            extensions = ua;
-            ua = undefined;
-        }
         this.nav = typeof globalThis.window !== 'undefined' ? globalThis.navigator : undefined;
         this.rgxMap = extensions ? extend(regexes, extensions) : regexes;
         const initialUa = ua || this.nav?.userAgent || '';
@@ -44,6 +83,11 @@ export class UAParser {
     nav;
     rgxMap;
     isSelfNav;
+    // Lazily cached results shared by the is* helpers (so multiple checks cost one parse),
+    // reset by setUA(). The get* methods deliberately stay uncached and return fresh objects.
+    cachedBrowser;
+    cachedOs;
+    cachedDevice;
     getBrowser() {
         const browser = { name: undefined, version: undefined, major: undefined };
         rgxMapper(browser, this.ua, this.rgxMap.browser);
@@ -105,8 +149,63 @@ export class UAParser {
     setUA(ua) {
         ua ||= '';
         this.ua = ua.length > UA_MAX_LENGTH ? ua.replace(/^\s\s*/, '').slice(0, UA_MAX_LENGTH) : ua;
+        this.cachedBrowser = this.cachedOs = this.cachedDevice = undefined;
         return this;
     }
+    /**
+     * True if the OS is iOS.
+     * Note: desktop-mode iPads send a Mac-like UA and are not detected as iOS
+     * (except when parsing the browser's own UA, where client-hints refinements apply).
+     */
+    isIos() {
+        return this.os().name === UAOSName.iOS;
+    }
+    isAndroid() {
+        return this.os().name === UAOSName.Android;
+    }
+    isMacOs() {
+        return this.os().name === UAOSName.MacOS;
+    }
+    isWindows() {
+        return this.os().name === UAOSName.Windows;
+    }
+    /**
+     * True for 'Chrome', 'Chrome WebView' and 'Chrome Headless' (not for Chromium).
+     */
+    isChrome() {
+        return !!this.browser().name?.startsWith(UABrowserName.Chrome);
+    }
+    /**
+     * True for 'Safari' and 'Mobile Safari' (not for bare-WebKit iOS in-app webviews).
+     */
+    isSafari() {
+        const { name } = this.browser();
+        return name === UABrowserName.Safari || name === UABrowserName.MobileSafari;
+    }
+    isFirefox() {
+        return this.browser().name === UABrowserName.Firefox;
+    }
+    isEdge() {
+        return this.browser().name === UABrowserName.Edge;
+    }
+    /**
+     * True if the device type is 'mobile' (phones; tablets are 'tablet' - see isTablet).
+     */
+    isMobile() {
+        return this.device().type === MOBILE;
+    }
+    isTablet() {
+        return this.device().type === TABLET;
+    }
+    browser() {
+        return (this.cachedBrowser ??= this.getBrowser());
+    }
+    os() {
+        return (this.cachedOs ??= this.getOS());
+    }
+    device() {
+        return (this.cachedDevice ??= this.getDevice());
+    }
 }
 ///////////
 // Helpers
@@ -230,9 +329,9 @@ const ASUS = 'ASUS';
 const BLACKBERRY = 'BlackBerry';
 const BROWSER = 'Browser';
 const SUFFIX_BROWSER = ' Browser';
-const CHROME = 'Chrome';
-const EDGE = 'Edge';
-const FIREFOX = 'Firefox';
+const CHROME = UABrowserName.Chrome;
+const EDGE = UABrowserName.Edge;
+const FIREFOX = UABrowserName.Firefox;
 const GOOGLE = 'Google';
 const HONOR = 'Honor';
 const HUAWEI = 'Huawei';
@@ -242,16 +341,16 @@ const MICROSOFT = 'Microsoft';
 const MOTOROLA = 'Motorola';
 const NVIDIA = 'Nvidia';
 const ONEPLUS = 'OnePlus';
-const OPERA = 'Opera';
+const OPERA = UABrowserName.Opera;
 const OPPO = 'OPPO';
 const SAMSUNG = 'Samsung';
 const SHARP = 'Sharp';
 const SONY = 'Sony';
 const XIAOMI = 'Xiaomi';
 const ZEBRA = 'Zebra';
-const FACEBOOK = 'Facebook';
-const CHROMIUM_OS = 'Chromium OS';
-const MAC_OS = 'Mac OS';
+const FACEBOOK = UABrowserName.Facebook;
+const CHROMIUM_OS = UAOSName.ChromiumOS;
+const MAC_OS = UAOSName.MacOS;
 ///////////////
 // String maps
 //////////////
@@ -289,11 +388,11 @@ const regexes = {
         [
             /\b(?:crmo|crios)\/([\w\.]+)/i, // Chrome for Android/iOS
         ],
-        [VERSION, [NAME, 'Chrome']],
+        [VERSION, [NAME, CHROME]],
         [
             /edg(?:e|ios|a)?\/([\w\.]+)/i, // Microsoft Edge
         ],
-        [VERSION, [NAME, 'Edge']],
+        [VERSION, [NAME, EDGE]],
         [
             // Presto based
             /(opera mini)\/([-\w\.]+)/i, // Opera Mini
@@ -415,7 +514,7 @@ const regexes = {
         [
             /samsungbrowser\/([\w\.]+)/i, // Samsung Internet
         ],
-        [VERSION, [NAME, SAMSUNG + ' Internet']],
+        [VERSION, [NAME, UABrowserName.SamsungInternet]],
         [
             /metasr[\/ ]?([\d\.]+)/i, // Sogou Explorer
         ],
@@ -468,11 +567,11 @@ const regexes = {
         [
             /headlesschrome(?:\/([\w\.]+)| )/i, // Chrome Headless
         ],
-        [VERSION, [NAME, CHROME + ' Headless']],
+        [VERSION, [NAME, UABrowserName.ChromeHeadless]],
         [
             / wv\).+(chrome)\/([\w\.]+)/i, // Chrome WebView
         ],
-        [[NAME, CHROME + ' WebView'], VERSION],
+        [[NAME, UABrowserName.ChromeWebView], VERSION],
         [
             /droid.+ version\/([\w\.]+)\b.+(?:mobile safari|safari)/i, // Android Browser
         ],
@@ -484,7 +583,7 @@ const regexes = {
         [
             /version\/([\w\.\,]+) .*mobile\/\w+ (safari)/i, // Mobile Safari
         ],
-        [VERSION, [NAME, 'Mobile Safari']],
+        [VERSION, [NAME, UABrowserName.MobileSafari]],
         [
             /version\/([\w(\.|\,)]+) .*(mobile ?safari|safari)/i, // Safari & Safari Mobile
         ],
@@ -1198,7 +1297,7 @@ const regexes = {
         ],
         [
             [VERSION, strMapper, windowsVersionMap],
-            [NAME, 'Windows'],
+            [NAME, UAOSName.Windows],
         ],
         [
             // iOS/macOS
@@ -1208,7 +1307,7 @@ const regexes = {
         ],
         [
             [VERSION, /_/g, '.'],
-            [NAME, 'iOS'],
+            [NAME, UAOSName.iOS],
         ],
         [
             /(mac os x) ?([\w\. ]*)/i,
@@ -1252,7 +1351,7 @@ const regexes = {
         [
             /watch(?: ?os[,\/]|\d,\d\/)([\d\.]+)/i, // watchOS
         ],
-        [VERSION, [NAME, 'watchOS']],
+        [VERSION, [NAME, UAOSName.WatchOS]],
         [
             // Google Chromecast
             /crkey\/([\d\.]+)/i, // Google Chromecast

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.86.0",
+  "version": "15.86.2",
   "dependencies": {
     "tslib": "^2"
   },
@@ -14,11 +14,11 @@
     }
   },
   "devDependencies": {
+    "@naturalcycles/dev-lib": "0.0.0",
     "@types/node": "^26",
     "@types/semver": "^7",
     "typescript": "^7",
-    "dayjs": "^1",
-    "@naturalcycles/dev-lib": "0.0.0"
+    "dayjs": "^1"
   },
   "exports": {
     ".": "./dist/index.js",

package/src/error/error.util.ts

@@ -226,12 +226,26 @@ export function _errorSnippet(err: any, opt: ErrorSnippetOptions = {}): string {
   }
 }
 
+// These duck-typing checks read properties of an arbitrary object, which may invoke its
+// property getters, which may throw (e.g a stateful getter, a Proxy trap).
+// A type guard should never throw - an object whose properties cannot even be read safely
+// is, by definition, not a well-behaved Error-like - hence try/catch returning false.
+// try/catch is free in V8 unless it actually catches, so there's no performance penalty.
+
 export function _isBackendErrorResponseObject(o: any): o is BackendErrorResponseObject {
-  return _isErrorObject(o?.error)
+  try {
+    return _isErrorObject(o?.error)
+  } catch {
+    return false
+  }
 }
 
 export function _isHttpRequestErrorObject(o: any): o is ErrorObject<HttpRequestErrorData> {
-  return !!o && o.name === 'HttpRequestError' && typeof o.data?.requestUrl === 'string'
+  try {
+    return !!o && o.name === 'HttpRequestError' && typeof o.data?.requestUrl === 'string'
+  } catch {
+    return false
+  }
 }
 
 /**
@@ -240,17 +254,27 @@ export function _isHttpRequestErrorObject(o: any): o is ErrorObject<HttpRequestE
 export function _isErrorObject<DATA_TYPE extends ErrorData = ErrorData>(
   o: any,
 ): o is ErrorObject<DATA_TYPE> {
-  return (
-    !!o &&
-    typeof o === 'object' &&
-    typeof o.name === 'string' &&
-    typeof o.message === 'string' &&
-    typeof o.data === 'object'
-  )
+  try {
+    return (
+      !!o &&
+      typeof o === 'object' &&
+      typeof o.name === 'string' &&
+      typeof o.message === 'string' &&
+      typeof o.data === 'object'
+    )
+  } catch {
+    return false
+  }
 }
 
 export function _isErrorLike(o: any): o is ErrorLike {
-  return !!o && typeof o === 'object' && typeof o.name === 'string' && typeof o.message === 'string'
+  try {
+    return (
+      !!o && typeof o === 'object' && typeof o.name === 'string' && typeof o.message === 'string'
+    )
+  } catch {
+    return false
+  }
 }
 
 /**

package/src/ua/ua.ts

@@ -16,9 +16,50 @@
 
 export type UADeviceType = 'console' | 'mobile' | 'tablet' | 'smarttv' | 'wearable' | 'embedded'
 
+/**
+ * Popular OS names as produced by the parser, for convenient comparisons
+ * (`os.name === UAOSName.iOS`) without magic strings.
+ *
+ * Not exhaustive - the parser emits many more names; compare against a string for the rest.
+ */
+export enum UAOSName {
+  iOS = 'iOS',
+  Android = 'Android',
+  MacOS = 'Mac OS',
+  Windows = 'Windows',
+  Linux = 'Linux',
+  ChromiumOS = 'Chromium OS',
+  WatchOS = 'watchOS',
+}
+
+/**
+ * Popular browser names as produced by the parser, for convenient comparisons
+ * (`browser.name === UABrowserName.Safari`) without magic strings.
+ *
+ * Not exhaustive - the parser emits many more names; compare against a string for the rest.
+ */
+export enum UABrowserName {
+  Chrome = 'Chrome',
+  ChromeWebView = 'Chrome WebView',
+  ChromeHeadless = 'Chrome Headless',
+  Safari = 'Safari',
+  MobileSafari = 'Mobile Safari',
+  Firefox = 'Firefox',
+  Edge = 'Edge',
+  Opera = 'Opera',
+  SamsungInternet = 'Samsung Internet',
+  Facebook = 'Facebook',
+  Instagram = 'Instagram',
+  /**
+   * Bare WebKit UA without a Safari token, typically an iOS in-app webview (e.g. WKWebView).
+   */
+  WebKit = 'WebKit',
+}
+
 export interface UABrowser {
   /**
    * E.g Chrome, Edge, Firefox, Safari, Mobile Safari, Opera, IE, UCBrowser, WeChat, ...
+   * Popular values are available as `UABrowserName`.
    */
   name: string | undefined
   version: string | undefined
@@ -59,6 +100,7 @@ export interface UAEngine {
 export interface UAOS {
   /**
    * E.g Windows, iOS, Mac OS, Android, Linux, Chromium OS, ...
+   * Popular values are available as `UAOSName`.
    */
   name: string | undefined
   version: string | undefined
@@ -125,6 +167,10 @@ export function parseUserAgent(userAgent?: string, extensions?: UAParserExtensio
   return new UAParser(userAgent, extensions).getResult()
 }
 
+export function uaParser(userAgent?: string, extensions?: UAParserExtensions): UAParser {
+  return new UAParser(userAgent, extensions)
+}
+
 /**
  * User-Agent parser.
  *
@@ -133,14 +179,7 @@ export function parseUserAgent(userAgent?: string, extensions?: UAParserExtensio
  * and reusing the compiled extensions across multiple `setUA()` calls.
  */
 export class UAParser {
-  constructor(ua?: string, extensions?: UAParserExtensions)
-  constructor(extensions: UAParserExtensions)
-  constructor(ua?: string | UAParserExtensions, extensions?: UAParserExtensions) {
-    if (typeof ua === 'object' && ua !== null) {
-      extensions = ua
-      ua = undefined
-    }
-
+  constructor(ua?: string, extensions?: UAParserExtensions) {
     this.nav = typeof globalThis.window !== 'undefined' ? globalThis.navigator : undefined
     this.rgxMap = extensions ? extend(regexes, extensions) : regexes
     const initialUa = ua || this.nav?.userAgent || ''
@@ -154,6 +193,11 @@ export class UAParser {
   private readonly nav: UaNavigator | undefined
   private readonly rgxMap: UARegexMaps
   private readonly isSelfNav: boolean
+  // Lazily cached results shared by the is* helpers (so multiple checks cost one parse),
+  // reset by setUA(). The get* methods deliberately stay uncached and return fresh objects.
+  private cachedBrowser?: UABrowser
+  private cachedOs?: UAOS
+  private cachedDevice?: UADevice
 
   getBrowser(): UABrowser {
     const browser: UABrowser = { name: undefined, version: undefined, major: undefined }
@@ -225,8 +269,76 @@ export class UAParser {
   setUA(ua: string | undefined): this {
     ua ||= ''
     this.ua = ua.length > UA_MAX_LENGTH ? ua.replace(/^\s\s*/, '').slice(0, UA_MAX_LENGTH) : ua
+    this.cachedBrowser = this.cachedOs = this.cachedDevice = undefined
     return this
   }
+
+  /**
+   * True if the OS is iOS.
+   * Note: desktop-mode iPads send a Mac-like UA and are not detected as iOS
+   * (except when parsing the browser's own UA, where client-hints refinements apply).
+   */
+  isIos(): boolean {
+    return this.os().name === UAOSName.iOS
+  }
+
+  isAndroid(): boolean {
+    return this.os().name === UAOSName.Android
+  }
+
+  isMacOs(): boolean {
+    return this.os().name === UAOSName.MacOS
+  }
+
+  isWindows(): boolean {
+    return this.os().name === UAOSName.Windows
+  }
+
+  /**
+   * True for 'Chrome', 'Chrome WebView' and 'Chrome Headless' (not for Chromium).
+   */
+  isChrome(): boolean {
+    return !!this.browser().name?.startsWith(UABrowserName.Chrome)
+  }
+
+  /**
+   * True for 'Safari' and 'Mobile Safari' (not for bare-WebKit iOS in-app webviews).
+   */
+  isSafari(): boolean {
+    const { name } = this.browser()
+    return name === UABrowserName.Safari || name === UABrowserName.MobileSafari
+  }
+
+  isFirefox(): boolean {
+    return this.browser().name === UABrowserName.Firefox
+  }
+
+  isEdge(): boolean {
+    return this.browser().name === UABrowserName.Edge
+  }
+
+  /**
+   * True if the device type is 'mobile' (phones; tablets are 'tablet' - see isTablet).
+   */
+  isMobile(): boolean {
+    return this.device().type === MOBILE
+  }
+
+  isTablet(): boolean {
+    return this.device().type === TABLET
+  }
+
+  private browser(): UABrowser {
+    return (this.cachedBrowser ??= this.getBrowser())
+  }
+
+  private os(): UAOS {
+    return (this.cachedOs ??= this.getOS())
+  }
+
+  private device(): UADevice {
+    return (this.cachedDevice ??= this.getDevice())
+  }
 }
 
 /**
@@ -384,9 +496,9 @@ const ASUS = 'ASUS'
 const BLACKBERRY = 'BlackBerry'
 const BROWSER = 'Browser'
 const SUFFIX_BROWSER = ' Browser'
-const CHROME = 'Chrome'
-const EDGE = 'Edge'
-const FIREFOX = 'Firefox'
+const CHROME = UABrowserName.Chrome
+const EDGE = UABrowserName.Edge
+const FIREFOX = UABrowserName.Firefox
 const GOOGLE = 'Google'
 const HONOR = 'Honor'
 const HUAWEI = 'Huawei'
@@ -396,16 +508,16 @@ const MICROSOFT = 'Microsoft'
 const MOTOROLA = 'Motorola'
 const NVIDIA = 'Nvidia'
 const ONEPLUS = 'OnePlus'
-const OPERA = 'Opera'
+const OPERA = UABrowserName.Opera
 const OPPO = 'OPPO'
 const SAMSUNG = 'Samsung'
 const SHARP = 'Sharp'
 const SONY = 'Sony'
 const XIAOMI = 'Xiaomi'
 const ZEBRA = 'Zebra'
-const FACEBOOK = 'Facebook'
-const CHROMIUM_OS = 'Chromium OS'
-const MAC_OS = 'Mac OS'
+const FACEBOOK = UABrowserName.Facebook
+const CHROMIUM_OS = UAOSName.ChromiumOS
+const MAC_OS = UAOSName.MacOS
 
 ///////////////
 // String maps
@@ -449,11 +561,11 @@ const regexes: UARegexMaps = {
     [
       /\b(?:crmo|crios)\/([\w\.]+)/i, // Chrome for Android/iOS
     ],
-    [VERSION, [NAME, 'Chrome']],
+    [VERSION, [NAME, CHROME]],
     [
       /edg(?:e|ios|a)?\/([\w\.]+)/i, // Microsoft Edge
     ],
-    [VERSION, [NAME, 'Edge']],
+    [VERSION, [NAME, EDGE]],
     [
       // Presto based
       /(opera mini)\/([-\w\.]+)/i, // Opera Mini
@@ -576,7 +688,7 @@ const regexes: UARegexMaps = {
     [
       /samsungbrowser\/([\w\.]+)/i, // Samsung Internet
     ],
-    [VERSION, [NAME, SAMSUNG + ' Internet']],
+    [VERSION, [NAME, UABrowserName.SamsungInternet]],
     [
       /metasr[\/ ]?([\d\.]+)/i, // Sogou Explorer
     ],
@@ -629,11 +741,11 @@ const regexes: UARegexMaps = {
     [
       /headlesschrome(?:\/([\w\.]+)| )/i, // Chrome Headless
     ],
-    [VERSION, [NAME, CHROME + ' Headless']],
+    [VERSION, [NAME, UABrowserName.ChromeHeadless]],
     [
       / wv\).+(chrome)\/([\w\.]+)/i, // Chrome WebView
     ],
-    [[NAME, CHROME + ' WebView'], VERSION],
+    [[NAME, UABrowserName.ChromeWebView], VERSION],
     [
       /droid.+ version\/([\w\.]+)\b.+(?:mobile safari|safari)/i, // Android Browser
     ],
@@ -645,7 +757,7 @@ const regexes: UARegexMaps = {
     [
       /version\/([\w\.\,]+) .*mobile\/\w+ (safari)/i, // Mobile Safari
     ],
-    [VERSION, [NAME, 'Mobile Safari']],
+    [VERSION, [NAME, UABrowserName.MobileSafari]],
     [
       /version\/([\w(\.|\,)]+) .*(mobile ?safari|safari)/i, // Safari & Safari Mobile
     ],
@@ -1372,7 +1484,7 @@ const regexes: UARegexMaps = {
     ],
     [
       [VERSION, strMapper, windowsVersionMap],
-      [NAME, 'Windows'],
+      [NAME, UAOSName.Windows],
     ],
     [
       // iOS/macOS
@@ -1382,7 +1494,7 @@ const regexes: UARegexMaps = {
     ],
     [
       [VERSION, /_/g, '.'],
-      [NAME, 'iOS'],
+      [NAME, UAOSName.iOS],
     ],
     [
       /(mac os x) ?([\w\. ]*)/i,
@@ -1426,7 +1538,7 @@ const regexes: UARegexMaps = {
     [
       /watch(?: ?os[,\/]|\d,\d\/)([\d\.]+)/i, // watchOS
     ],
-    [VERSION, [NAME, 'watchOS']],
+    [VERSION, [NAME, UAOSName.WatchOS]],
     [
       // Google Chromecast
       /crkey\/([\d\.]+)/i, // Google Chromecast