@ybgnb/utils 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -2,3 +2,6 @@ export * from './types/error';
 export * from './types/extended-type';
 export * from './utils/base-utils';
 export * from './utils/biz-result';
+export * from './utils/function-utils';
+export * from './utils/network-utils';
+export * from './utils/page-utils';

package/dist/index.mjs

@@ -1,15 +1,4 @@
 import dayjs from "dayjs";
-class CommonError {
-  message;
-  constructor(message) {
-    this.message = message;
-  }
-}
-class AbortedError extends CommonError {
-  constructor() {
-    super("操作已取消");
-  }
-}
 class BaseUtils {
   /**
    * 判断是否为通用异常
@@ -32,7 +21,7 @@ class BaseUtils {
    */
   static prependErrorMessage(error, preMsg) {
     if (preMsg) {
-      error.message = `${preMsg}${error.message}`;
+      error.message = `${preMsg} ${error.message}`;
     }
     return error;
   }
@@ -56,24 +45,37 @@ class BaseUtils {
    * 格式化时间为 2020-02-02 20:20:20 的字符串
    * @param date 需要格式化的时间，为空则获取当前时间
    */
-  static getFormatedDateTime(date) {
+  static getFormattedDateTime(date) {
     return dayjs(date).format("YYYY-MM-DD HH:mm:ss");
   }
   /**
    * 格式化时间为 2020-02-02 的字符串
    * @param date 需要格式化的时间，为空则获取当前时间
    */
-  static getFormatedDate(date) {
+  static getFormattedDate(date) {
     return dayjs(date).format("YYYY-MM-DD");
   }
   /**
    * 格式化时间为 20:20:20 的字符串
    * @param date 需要格式化的时间，为空则获取当前时间
    */
-  static getFormatedTime(date) {
+  static getFormattedTime(date) {
     return dayjs(date).format("HH:mm:ss");
   }
 }
+class CommonError {
+  message;
+  error;
+  constructor(message, error) {
+    this.message = error ? `${message} ${BaseUtils.getErrorMessage(error)}` : message;
+    this.error = error;
+  }
+}
+class AbortedError extends CommonError {
+  constructor() {
+    super("操作已取消");
+  }
+}
 class BizResult {
   success;
   msg;
@@ -107,11 +109,86 @@ const execBiz = async (run) => {
     return BizResult.createError(e);
   }
 };
+function runRandomFunctions(fns, maxCount) {
+  maxCount = maxCount ?? fns.length;
+  const count = Math.floor(Math.random() * maxCount) + 1;
+  const shuffled = [...fns];
+  for (let i = shuffled.length - 1; i > 0; i--) {
+    const j = Math.floor(Math.random() * (i + 1));
+    [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+  }
+  const selected = shuffled.slice(0, count);
+  for (const fn of selected) {
+    fn();
+  }
+}
+function isConnection(obj) {
+  return obj && typeof obj === "object" && "downlink" in obj && "rtt" in obj && "effectiveType" in obj;
+}
+function getNetworkInfo() {
+  if (!navigator.onLine) {
+    return "offline";
+  }
+  if ("connection" in navigator && isConnection(navigator.connection)) {
+    const connection = navigator.connection;
+    return {
+      downlink: connection.downlink,
+      rtt: connection.rtt,
+      effectiveType: connection.effectiveType
+    };
+  } else {
+    return "online";
+  }
+}
+function onNetworkChange(listener) {
+  const handleChange = () => {
+    listener(getNetworkInfo());
+  };
+  if ("connection" in navigator && isConnection(navigator.connection)) {
+    let connection = navigator.connection;
+    connection.addEventListener("change", handleChange);
+    return () => connection.removeEventListener("change", handleChange);
+  } else {
+    window.addEventListener("online", handleChange);
+    window.addEventListener("offline", handleChange);
+    return () => {
+      window.removeEventListener("online", handleChange);
+      window.removeEventListener("offline", handleChange);
+    };
+  }
+}
+function onVisibilityChange(listener) {
+  let hiddenPropName = void 0, hiddenEventName = void 0;
+  if (typeof document.hidden !== "undefined") {
+    hiddenPropName = "hidden";
+    hiddenEventName = "visibilitychange";
+  } else if ("msHidden" in document && typeof document.msHidden !== "undefined") {
+    hiddenPropName = "msHidden";
+    hiddenEventName = "msvisibilitychange";
+  } else if ("webkitHidden" in document && typeof document.webkitHidden !== "undefined") {
+    hiddenPropName = "webkitHidden";
+    hiddenEventName = "webkitvisibilitychange";
+  }
+  if (!hiddenPropName || !hiddenEventName) {
+    return null;
+  }
+  const handler = () => {
+    listener(document[hiddenPropName]);
+  };
+  document.addEventListener(hiddenEventName, handler);
+  return () => {
+    document.removeEventListener(hiddenEventName, handler);
+  };
+}
 export {
   AbortedError,
   BaseUtils,
   BizResult,
   CommonError,
-  execBiz
+  execBiz,
+  getNetworkInfo,
+  onNetworkChange,
+  onVisibilityChange,
+  runRandomFunctions
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/types/error.ts","../src/utils/base-utils.ts","../src/utils/biz-result.ts"],"sourcesContent":["/**\n * 通用异常\n */\nexport class CommonError {\n  message: string;\n\n  constructor(message: string) {\n    this.message = message;\n  }\n}\n\n/**\n * 终止异常\n */\nexport class AbortedError extends CommonError {\n  constructor() {\n    super(\"操作已取消\");\n  }\n}\n","import dayjs from 'dayjs';\nimport { CommonError } from '../types/error';\n\n/**\n * 基础工具集\n */\nexport class BaseUtils {\n  /**\n   * 判断是否为通用异常\n   * @param error 需要判断的异常\n   */\n  static isCommonError(error: unknown): error is CommonError {\n    return error instanceof CommonError\n  }\n\n  /**\n   * 获取错误信息\n   * @param error\n   */\n  static getErrorMessage(error: unknown): string {\n    return this.convertToCommonError(error).message\n  }\n\n  /**\n   * 设置异常信息的前置提示\n   * @param error 异常\n   * @param preMsg  前置信息  `${preMsg}${error.message}`\n   */\n  static prependErrorMessage(error: CommonError, preMsg?: string): CommonError {\n    if (preMsg) {\n      error.message = `${preMsg}${error.message}`\n    }\n    return error\n  }\n\n  /**\n   * 转换到通用异常\n   * @param error 异常\n   * @param preMsg  前置提示 `${preMsg}${error.message}`\n   */\n  static convertToCommonError(error: unknown, preMsg?: string): CommonError {\n    if (this.isCommonError(error)) {\n      return this.prependErrorMessage(error, preMsg)\n    }\n    if (\n      typeof error === 'object' &&\n      error !== null &&\n      'message' in error &&\n      typeof (error as Record<string, unknown>).message === 'string'\n    ) {\n      const newError = error as { message: string }\n      return this.prependErrorMessage(new CommonError(newError.message), preMsg)\n    } else {\n      // 如果抛出的异常不是object\n      return this.prependErrorMessage(new CommonError(String(error)), preMsg)\n    }\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDateTime(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD HH:mm:ss')\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDate(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD')\n  }\n\n  /**\n   * 格式化时间为 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedTime(date?: Date): string {\n    return dayjs(date).format('HH:mm:ss')\n  }\n}\n","import { CommonError } from '../types/error'\nimport { BaseUtils } from './base-utils'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, BaseUtils.getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n"],"names":[],"mappings":";AAGO,MAAM,YAAY;AAAA,EACvB;AAAA,EAEA,YAAY,SAAiB;AAC3B,SAAK,UAAU;AAAA,EACjB;AACF;AAKO,MAAM,qBAAqB,YAAY;AAAA,EAC5C,cAAc;AACZ,UAAM,OAAO;AAAA,EACf;AACF;ACZO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA,EAKrB,OAAO,cAAc,OAAsC;AACzD,WAAO,iBAAiB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,gBAAgB,OAAwB;AAC7C,WAAO,KAAK,qBAAqB,KAAK,EAAE;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,oBAAoB,OAAoB,QAA8B;AAC3E,QAAI,QAAQ;AACV,YAAM,UAAU,GAAG,MAAM,GAAG,MAAM,OAAO;AAAA,IAC3C;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,qBAAqB,OAAgB,QAA8B;AACxE,QAAI,KAAK,cAAc,KAAK,GAAG;AAC7B,aAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,IAC/C;AACA,QACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAQ,MAAkC,YAAY,UACtD;AACA,YAAM,WAAW;AACjB,aAAO,KAAK,oBAAoB,IAAI,YAAY,SAAS,OAAO,GAAG,MAAM;AAAA,IAC3E,OAAO;AAEL,aAAO,KAAK,oBAAoB,IAAI,YAAY,OAAO,KAAK,CAAC,GAAG,MAAM;AAAA,IACxE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,oBAAoB,MAAqB;AAC9C,WAAO,MAAM,IAAI,EAAE,OAAO,qBAAqB;AAAA,EACjD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,gBAAgB,MAAqB;AAC1C,WAAO,MAAM,IAAI,EAAE,OAAO,YAAY;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,gBAAgB,MAAqB;AAC1C,WAAO,MAAM,IAAI,EAAE,OAAO,UAAU;AAAA,EACtC;AACF;AC3EO,MAAM,UAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,SAAkB,KAAa,MAAU;AACnD,SAAK,UAAU;AACf,SAAK,MAAM;AACX,SAAK,OAAO;AAAA,EACd;AAAA,EAEA,OAAO,cAAiB,MAAS;AAC/B,WAAO,IAAI,UAAU,MAAM,QAAQ,IAAI;AAAA,EACzC;AAAA,EAEA,OAAO,WAAc,MAAc,QAAQ,MAAU;AACnD,WAAO,IAAI,UAAU,OAAO,KAAK,IAAI;AAAA,EACvC;AAAA,EAEA,OAAO,YAAe,GAAY;AAChC,WAAO,IAAI,UAAa,OAAO,UAAU,gBAAgB,CAAC,CAAC;AAAA,EAC7D;AAAA,EAOA,MAAM,YAAkC;AACtC,QAAI,KAAK,SAAS;AAChB,aAAO,KAAK;AAAA,IACd,OAAO;AACL,YAAM,IAAI,YAAY,KAAK,GAAG;AAAA,IAChC;AAAA,EACF;AACF;AAMO,MAAM,UAAU,OAAU,QAAiD;AAChF,MAAI;AACF,WAAO,UAAU,cAAiB,MAAM,KAAK;AAAA,EAC/C,SAAS,GAAG;AACV,WAAO,UAAU,YAAY,CAAC;AAAA,EAChC;AACF;"}
+{"version":3,"file":"index.mjs","sources":["../src/utils/base-utils.ts","../src/types/error.ts","../src/utils/biz-result.ts","../src/utils/function-utils.ts","../src/utils/network-utils.ts","../src/utils/page-utils.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport { CommonError } from '../types/error';\n\n/**\n * 基础工具集\n */\nexport class BaseUtils {\n  /**\n   * 判断是否为通用异常\n   * @param error 需要判断的异常\n   */\n  static isCommonError(error: unknown): error is CommonError {\n    return error instanceof CommonError\n  }\n\n  /**\n   * 获取错误信息\n   * @param error\n   */\n  static getErrorMessage(error: unknown): string {\n    return this.convertToCommonError(error).message\n  }\n\n  /**\n   * 设置异常信息的前置提示\n   * @param error 异常\n   * @param preMsg  前置信息  `${preMsg}${error.message}`\n   */\n  static prependErrorMessage(error: CommonError, preMsg?: string): CommonError {\n    if (preMsg) {\n      error.message = `${preMsg} ${error.message}`\n    }\n    return error\n  }\n\n  /**\n   * 转换到通用异常\n   * @param error 异常\n   * @param preMsg  前置提示 `${preMsg}${error.message}`\n   */\n  static convertToCommonError(error: unknown, preMsg?: string): CommonError {\n    if (this.isCommonError(error)) {\n      return this.prependErrorMessage(error, preMsg)\n    }\n    if (\n      typeof error === 'object' &&\n      error !== null &&\n      'message' in error &&\n      typeof (error as Record<string, unknown>).message === 'string'\n    ) {\n      const newError = error as { message: string }\n      return this.prependErrorMessage(new CommonError(newError.message), preMsg)\n    } else {\n      // 如果抛出的异常不是object\n      return this.prependErrorMessage(new CommonError(String(error)), preMsg)\n    }\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormattedDateTime(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD HH:mm:ss')\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormattedDate(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD')\n  }\n\n  /**\n   * 格式化时间为 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormattedTime(date?: Date): string {\n    return dayjs(date).format('HH:mm:ss')\n  }\n}\n","import {BaseUtils} from \"../utils/base-utils.ts\";\n\n/**\n * 通用异常\n */\nexport class CommonError {\n  message: string;\n  error?: unknown;\n\n  constructor(message: string, error?: unknown) {\n    this.message = error ? `${message} ${BaseUtils.getErrorMessage(error)}` : message;\n    this.error = error;\n  }\n}\n\n/**\n * 中止异常\n */\nexport class AbortedError extends CommonError {\n  constructor() {\n    super(\"操作已取消\");\n  }\n}\n","import { CommonError } from '../types/error'\nimport { BaseUtils } from './base-utils'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, BaseUtils.getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n","/**\n * 随机运行参数\n * @param fns\n * @param maxCount 最多执行次数（1 ~ fns.length）\n */\nexport function runRandomFunctions(fns: Array<() => void>, maxCount?: number): void {\n  maxCount = maxCount ?? fns.length\n  const count = Math.floor(Math.random() * maxCount) + 1\n\n  const shuffled = [...fns]\n  for (let i = shuffled.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1))\n    ;[shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]]\n  }\n\n  const selected = shuffled.slice(0, count)\n\n  for (const fn of selected) {\n    fn()\n  }\n}\n","interface NetworkInformation extends EventTarget {\n  // 带宽（估算）\n  downlink: number;\n  // 延迟（估算）\n  rtt: number;\n  // 类型（估算）\n  effectiveType: 'slow-2g' | '2g' | '3g' | '4g';\n}\n\n/**\n * 网络状态信息\n * - 'offline': 无网络\n * - 'online': 在线但不支持 NetworkInformation API\n * - NetworkInformation: 含详细网络信息\n */\nexport type NetworkInfo = 'offline' | Omit<NetworkInformation, keyof EventTarget> | 'online'\n\nfunction isConnection(obj: any): obj is NetworkInformation {\n  return obj && typeof obj === 'object' && 'downlink' in obj && 'rtt' in obj && 'effectiveType' in obj;\n}\n\n/**\n * 获取网络信息\n */\nexport function getNetworkInfo(): NetworkInfo {\n  if (!navigator.onLine) {\n    return 'offline'\n  }\n\n  if ('connection' in navigator && isConnection(navigator.connection)) {\n    // 现代 Web API 直接获取网络连接的信息\n    const connection = navigator.connection;\n    return {\n      downlink: connection.downlink,\n      rtt: connection.rtt,\n      effectiveType: connection.effectiveType\n    }\n  } else {\n    return 'online'\n  }\n\n}\n\n/**\n * 监听网络状态变化\n * @param listener 监听器\n * @returns 成功监听时返回解绑函数\n */\nexport function onNetworkChange(listener: (info: NetworkInfo) => void) {\n\n  const handleChange = () => {\n    listener(getNetworkInfo())\n  }\n\n  if ('connection' in navigator && isConnection(navigator.connection)) {\n    // 现代 Web API\n    let connection = navigator.connection;\n    connection.addEventListener('change', handleChange)\n    return () => connection.removeEventListener('change', handleChange);\n  } else {\n\n    window.addEventListener('online', handleChange)\n    window.addEventListener('offline', handleChange)\n    return () => {\n      window.removeEventListener('online', handleChange);\n      window.removeEventListener('offline', handleChange);\n    };\n  }\n}\n","// 可见性改变的监听器\nexport interface VisibilityChangeListener {\n  (hidden: boolean): void;\n}\n\n/**\n * 监听页面可见性变化（兼容旧的IE/Chrome）\n * @param listener 监听器\n * @returns 成功监听时返回解绑函数\n */\nexport function onVisibilityChange(listener: VisibilityChangeListener) {\n  let hiddenPropName: string | undefined = undefined,\n    hiddenEventName: string | undefined = undefined;\n\n  if (typeof document.hidden !== \"undefined\") {\n    // 现代 Web API\n    hiddenPropName = 'hidden';\n    hiddenEventName = 'visibilitychange'\n  } else if ('msHidden' in document && typeof document.msHidden !== \"undefined\") {\n    // 旧 IE\n    hiddenPropName = 'msHidden';\n    hiddenEventName = 'msvisibilitychange'\n  } else if ('webkitHidden' in document && typeof document.webkitHidden !== \"undefined\") {\n    // 旧 Chrome\n    hiddenPropName = 'webkitHidden';\n    hiddenEventName = 'webkitvisibilitychange'\n  }\n\n  if (!hiddenPropName || !hiddenEventName) {\n    return null;\n  }\n\n  const handler = () => {\n    // @ts-ignore\n    listener(document[hiddenPropName]);\n  };\n\n  document.addEventListener(hiddenEventName, handler);\n\n  return () => {\n    document.removeEventListener(hiddenEventName, handler);\n  };\n}\n\n"],"names":[],"mappings":"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"}

package/dist/index.umd.js

@@ -2,17 +2,6 @@
   typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("dayjs")) : typeof define === "function" && define.amd ? define(["exports", "dayjs"], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, factory(global["ybgnb-js-utils"] = {}, global.dayjs));
 })(this, (function(exports2, dayjs) {
   "use strict";
-  class CommonError {
-    message;
-    constructor(message) {
-      this.message = message;
-    }
-  }
-  class AbortedError extends CommonError {
-    constructor() {
-      super("操作已取消");
-    }
-  }
   class BaseUtils {
     /**
      * 判断是否为通用异常
@@ -35,7 +24,7 @@
      */
     static prependErrorMessage(error, preMsg) {
       if (preMsg) {
-        error.message = `${preMsg}${error.message}`;
+        error.message = `${preMsg} ${error.message}`;
       }
       return error;
     }
@@ -59,24 +48,37 @@
      * 格式化时间为 2020-02-02 20:20:20 的字符串
      * @param date 需要格式化的时间，为空则获取当前时间
      */
-    static getFormatedDateTime(date) {
+    static getFormattedDateTime(date) {
       return dayjs(date).format("YYYY-MM-DD HH:mm:ss");
     }
     /**
      * 格式化时间为 2020-02-02 的字符串
      * @param date 需要格式化的时间，为空则获取当前时间
      */
-    static getFormatedDate(date) {
+    static getFormattedDate(date) {
       return dayjs(date).format("YYYY-MM-DD");
     }
     /**
      * 格式化时间为 20:20:20 的字符串
      * @param date 需要格式化的时间，为空则获取当前时间
      */
-    static getFormatedTime(date) {
+    static getFormattedTime(date) {
       return dayjs(date).format("HH:mm:ss");
     }
   }
+  class CommonError {
+    message;
+    error;
+    constructor(message, error) {
+      this.message = error ? `${message} ${BaseUtils.getErrorMessage(error)}` : message;
+      this.error = error;
+    }
+  }
+  class AbortedError extends CommonError {
+    constructor() {
+      super("操作已取消");
+    }
+  }
   class BizResult {
     success;
     msg;
@@ -110,11 +112,86 @@
       return BizResult.createError(e);
     }
   };
+  function runRandomFunctions(fns, maxCount) {
+    maxCount = maxCount ?? fns.length;
+    const count = Math.floor(Math.random() * maxCount) + 1;
+    const shuffled = [...fns];
+    for (let i = shuffled.length - 1; i > 0; i--) {
+      const j = Math.floor(Math.random() * (i + 1));
+      [shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]];
+    }
+    const selected = shuffled.slice(0, count);
+    for (const fn of selected) {
+      fn();
+    }
+  }
+  function isConnection(obj) {
+    return obj && typeof obj === "object" && "downlink" in obj && "rtt" in obj && "effectiveType" in obj;
+  }
+  function getNetworkInfo() {
+    if (!navigator.onLine) {
+      return "offline";
+    }
+    if ("connection" in navigator && isConnection(navigator.connection)) {
+      const connection = navigator.connection;
+      return {
+        downlink: connection.downlink,
+        rtt: connection.rtt,
+        effectiveType: connection.effectiveType
+      };
+    } else {
+      return "online";
+    }
+  }
+  function onNetworkChange(listener) {
+    const handleChange = () => {
+      listener(getNetworkInfo());
+    };
+    if ("connection" in navigator && isConnection(navigator.connection)) {
+      let connection = navigator.connection;
+      connection.addEventListener("change", handleChange);
+      return () => connection.removeEventListener("change", handleChange);
+    } else {
+      window.addEventListener("online", handleChange);
+      window.addEventListener("offline", handleChange);
+      return () => {
+        window.removeEventListener("online", handleChange);
+        window.removeEventListener("offline", handleChange);
+      };
+    }
+  }
+  function onVisibilityChange(listener) {
+    let hiddenPropName = void 0, hiddenEventName = void 0;
+    if (typeof document.hidden !== "undefined") {
+      hiddenPropName = "hidden";
+      hiddenEventName = "visibilitychange";
+    } else if ("msHidden" in document && typeof document.msHidden !== "undefined") {
+      hiddenPropName = "msHidden";
+      hiddenEventName = "msvisibilitychange";
+    } else if ("webkitHidden" in document && typeof document.webkitHidden !== "undefined") {
+      hiddenPropName = "webkitHidden";
+      hiddenEventName = "webkitvisibilitychange";
+    }
+    if (!hiddenPropName || !hiddenEventName) {
+      return null;
+    }
+    const handler = () => {
+      listener(document[hiddenPropName]);
+    };
+    document.addEventListener(hiddenEventName, handler);
+    return () => {
+      document.removeEventListener(hiddenEventName, handler);
+    };
+  }
   exports2.AbortedError = AbortedError;
   exports2.BaseUtils = BaseUtils;
   exports2.BizResult = BizResult;
   exports2.CommonError = CommonError;
   exports2.execBiz = execBiz;
+  exports2.getNetworkInfo = getNetworkInfo;
+  exports2.onNetworkChange = onNetworkChange;
+  exports2.onVisibilityChange = onVisibilityChange;
+  exports2.runRandomFunctions = runRandomFunctions;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 }));
 //# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.umd.js","sources":["../src/types/error.ts","../src/utils/base-utils.ts","../src/utils/biz-result.ts"],"sourcesContent":["/**\n * 通用异常\n */\nexport class CommonError {\n  message: string;\n\n  constructor(message: string) {\n    this.message = message;\n  }\n}\n\n/**\n * 终止异常\n */\nexport class AbortedError extends CommonError {\n  constructor() {\n    super(\"操作已取消\");\n  }\n}\n","import dayjs from 'dayjs';\nimport { CommonError } from '../types/error';\n\n/**\n * 基础工具集\n */\nexport class BaseUtils {\n  /**\n   * 判断是否为通用异常\n   * @param error 需要判断的异常\n   */\n  static isCommonError(error: unknown): error is CommonError {\n    return error instanceof CommonError\n  }\n\n  /**\n   * 获取错误信息\n   * @param error\n   */\n  static getErrorMessage(error: unknown): string {\n    return this.convertToCommonError(error).message\n  }\n\n  /**\n   * 设置异常信息的前置提示\n   * @param error 异常\n   * @param preMsg  前置信息  `${preMsg}${error.message}`\n   */\n  static prependErrorMessage(error: CommonError, preMsg?: string): CommonError {\n    if (preMsg) {\n      error.message = `${preMsg}${error.message}`\n    }\n    return error\n  }\n\n  /**\n   * 转换到通用异常\n   * @param error 异常\n   * @param preMsg  前置提示 `${preMsg}${error.message}`\n   */\n  static convertToCommonError(error: unknown, preMsg?: string): CommonError {\n    if (this.isCommonError(error)) {\n      return this.prependErrorMessage(error, preMsg)\n    }\n    if (\n      typeof error === 'object' &&\n      error !== null &&\n      'message' in error &&\n      typeof (error as Record<string, unknown>).message === 'string'\n    ) {\n      const newError = error as { message: string }\n      return this.prependErrorMessage(new CommonError(newError.message), preMsg)\n    } else {\n      // 如果抛出的异常不是object\n      return this.prependErrorMessage(new CommonError(String(error)), preMsg)\n    }\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDateTime(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD HH:mm:ss')\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedDate(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD')\n  }\n\n  /**\n   * 格式化时间为 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormatedTime(date?: Date): string {\n    return dayjs(date).format('HH:mm:ss')\n  }\n}\n","import { CommonError } from '../types/error'\nimport { BaseUtils } from './base-utils'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, BaseUtils.getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n"],"names":[],"mappings":";;;;EAGO,MAAM,YAAY;AAAA,IACvB;AAAA,IAEA,YAAY,SAAiB;AAC3B,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA,EAKO,MAAM,qBAAqB,YAAY;AAAA,IAC5C,cAAc;AACZ,YAAM,OAAO;AAAA,IACf;AAAA,EACF;AAAA,ECZO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA,IAKrB,OAAO,cAAc,OAAsC;AACzD,aAAO,iBAAiB;AAAA,IAC1B;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,gBAAgB,OAAwB;AAC7C,aAAO,KAAK,qBAAqB,KAAK,EAAE;AAAA,IAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,OAAO,oBAAoB,OAAoB,QAA8B;AAC3E,UAAI,QAAQ;AACV,cAAM,UAAU,GAAG,MAAM,GAAG,MAAM,OAAO;AAAA,MAC3C;AACA,aAAO;AAAA,IACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,OAAO,qBAAqB,OAAgB,QAA8B;AACxE,UAAI,KAAK,cAAc,KAAK,GAAG;AAC7B,eAAO,KAAK,oBAAoB,OAAO,MAAM;AAAA,MAC/C;AACA,UACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAQ,MAAkC,YAAY,UACtD;AACA,cAAM,WAAW;AACjB,eAAO,KAAK,oBAAoB,IAAI,YAAY,SAAS,OAAO,GAAG,MAAM;AAAA,MAC3E,OAAO;AAEL,eAAO,KAAK,oBAAoB,IAAI,YAAY,OAAO,KAAK,CAAC,GAAG,MAAM;AAAA,MACxE;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,oBAAoB,MAAqB;AAC9C,aAAO,MAAM,IAAI,EAAE,OAAO,qBAAqB;AAAA,IACjD;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,gBAAgB,MAAqB;AAC1C,aAAO,MAAM,IAAI,EAAE,OAAO,YAAY;AAAA,IACxC;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,OAAO,gBAAgB,MAAqB;AAC1C,aAAO,MAAM,IAAI,EAAE,OAAO,UAAU;AAAA,IACtC;AAAA,EACF;AAAA,EC3EO,MAAM,UAAa;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IAEA,YAAY,SAAkB,KAAa,MAAU;AACnD,WAAK,UAAU;AACf,WAAK,MAAM;AACX,WAAK,OAAO;AAAA,IACd;AAAA,IAEA,OAAO,cAAiB,MAAS;AAC/B,aAAO,IAAI,UAAU,MAAM,QAAQ,IAAI;AAAA,IACzC;AAAA,IAEA,OAAO,WAAc,MAAc,QAAQ,MAAU;AACnD,aAAO,IAAI,UAAU,OAAO,KAAK,IAAI;AAAA,IACvC;AAAA,IAEA,OAAO,YAAe,GAAY;AAChC,aAAO,IAAI,UAAa,OAAO,UAAU,gBAAgB,CAAC,CAAC;AAAA,IAC7D;AAAA,IAOA,MAAM,YAAkC;AACtC,UAAI,KAAK,SAAS;AAChB,eAAO,KAAK;AAAA,MACd,OAAO;AACL,cAAM,IAAI,YAAY,KAAK,GAAG;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AAMO,QAAM,UAAU,OAAU,QAAiD;AAChF,QAAI;AACF,aAAO,UAAU,cAAiB,MAAM,KAAK;AAAA,IAC/C,SAAS,GAAG;AACV,aAAO,UAAU,YAAY,CAAC;AAAA,IAChC;AAAA,EACF;;;;;;;;"}
+{"version":3,"file":"index.umd.js","sources":["../src/utils/base-utils.ts","../src/types/error.ts","../src/utils/biz-result.ts","../src/utils/function-utils.ts","../src/utils/network-utils.ts","../src/utils/page-utils.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport { CommonError } from '../types/error';\n\n/**\n * 基础工具集\n */\nexport class BaseUtils {\n  /**\n   * 判断是否为通用异常\n   * @param error 需要判断的异常\n   */\n  static isCommonError(error: unknown): error is CommonError {\n    return error instanceof CommonError\n  }\n\n  /**\n   * 获取错误信息\n   * @param error\n   */\n  static getErrorMessage(error: unknown): string {\n    return this.convertToCommonError(error).message\n  }\n\n  /**\n   * 设置异常信息的前置提示\n   * @param error 异常\n   * @param preMsg  前置信息  `${preMsg}${error.message}`\n   */\n  static prependErrorMessage(error: CommonError, preMsg?: string): CommonError {\n    if (preMsg) {\n      error.message = `${preMsg} ${error.message}`\n    }\n    return error\n  }\n\n  /**\n   * 转换到通用异常\n   * @param error 异常\n   * @param preMsg  前置提示 `${preMsg}${error.message}`\n   */\n  static convertToCommonError(error: unknown, preMsg?: string): CommonError {\n    if (this.isCommonError(error)) {\n      return this.prependErrorMessage(error, preMsg)\n    }\n    if (\n      typeof error === 'object' &&\n      error !== null &&\n      'message' in error &&\n      typeof (error as Record<string, unknown>).message === 'string'\n    ) {\n      const newError = error as { message: string }\n      return this.prependErrorMessage(new CommonError(newError.message), preMsg)\n    } else {\n      // 如果抛出的异常不是object\n      return this.prependErrorMessage(new CommonError(String(error)), preMsg)\n    }\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormattedDateTime(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD HH:mm:ss')\n  }\n\n  /**\n   * 格式化时间为 2020-02-02 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormattedDate(date?: Date): string {\n    return dayjs(date).format('YYYY-MM-DD')\n  }\n\n  /**\n   * 格式化时间为 20:20:20 的字符串\n   * @param date 需要格式化的时间，为空则获取当前时间\n   */\n  static getFormattedTime(date?: Date): string {\n    return dayjs(date).format('HH:mm:ss')\n  }\n}\n","import {BaseUtils} from \"../utils/base-utils.ts\";\n\n/**\n * 通用异常\n */\nexport class CommonError {\n  message: string;\n  error?: unknown;\n\n  constructor(message: string, error?: unknown) {\n    this.message = error ? `${message} ${BaseUtils.getErrorMessage(error)}` : message;\n    this.error = error;\n  }\n}\n\n/**\n * 中止异常\n */\nexport class AbortedError extends CommonError {\n  constructor() {\n    super(\"操作已取消\");\n  }\n}\n","import { CommonError } from '../types/error'\nimport { BaseUtils } from './base-utils'\n\n/**\n * 业务执行结果\n */\nexport class BizResult<T> {\n  success: boolean\n  msg: string\n  data?: T\n\n  constructor(success: boolean, msg: string, data?: T) {\n    this.success = success\n    this.msg = msg\n    this.data = data\n  }\n\n  static createSuccess<T>(data: T) {\n    return new BizResult(true, '操作成功', data)\n  }\n\n  static createFail<T>(msg: string = '操作失败', data?: T) {\n    return new BizResult(false, msg, data)\n  }\n\n  static createError<T>(e: unknown) {\n    return new BizResult<T>(false, BaseUtils.getErrorMessage(e))\n  }\n\n  /**\n   * 展开成Promise\n   */\n  async toPromise(): Promise<void>\n  async toPromise<T>(): Promise<T>\n  async toPromise<T = void>(): Promise<T> {\n    if (this.success) {\n      return this.data as T\n    } else {\n      throw new CommonError(this.msg)\n    }\n  }\n}\n\n/**\n * 执行业务（自动包裹BuResult）\n * @param run 执行方法\n */\nexport const execBiz = async <T>(run: () => Promise<T>): Promise<BizResult<T>> => {\n  try {\n    return BizResult.createSuccess<T>(await run())\n  } catch (e) {\n    return BizResult.createError(e)\n  }\n}\n","/**\n * 随机运行参数\n * @param fns\n * @param maxCount 最多执行次数（1 ~ fns.length）\n */\nexport function runRandomFunctions(fns: Array<() => void>, maxCount?: number): void {\n  maxCount = maxCount ?? fns.length\n  const count = Math.floor(Math.random() * maxCount) + 1\n\n  const shuffled = [...fns]\n  for (let i = shuffled.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1))\n    ;[shuffled[i], shuffled[j]] = [shuffled[j], shuffled[i]]\n  }\n\n  const selected = shuffled.slice(0, count)\n\n  for (const fn of selected) {\n    fn()\n  }\n}\n","interface NetworkInformation extends EventTarget {\n  // 带宽（估算）\n  downlink: number;\n  // 延迟（估算）\n  rtt: number;\n  // 类型（估算）\n  effectiveType: 'slow-2g' | '2g' | '3g' | '4g';\n}\n\n/**\n * 网络状态信息\n * - 'offline': 无网络\n * - 'online': 在线但不支持 NetworkInformation API\n * - NetworkInformation: 含详细网络信息\n */\nexport type NetworkInfo = 'offline' | Omit<NetworkInformation, keyof EventTarget> | 'online'\n\nfunction isConnection(obj: any): obj is NetworkInformation {\n  return obj && typeof obj === 'object' && 'downlink' in obj && 'rtt' in obj && 'effectiveType' in obj;\n}\n\n/**\n * 获取网络信息\n */\nexport function getNetworkInfo(): NetworkInfo {\n  if (!navigator.onLine) {\n    return 'offline'\n  }\n\n  if ('connection' in navigator && isConnection(navigator.connection)) {\n    // 现代 Web API 直接获取网络连接的信息\n    const connection = navigator.connection;\n    return {\n      downlink: connection.downlink,\n      rtt: connection.rtt,\n      effectiveType: connection.effectiveType\n    }\n  } else {\n    return 'online'\n  }\n\n}\n\n/**\n * 监听网络状态变化\n * @param listener 监听器\n * @returns 成功监听时返回解绑函数\n */\nexport function onNetworkChange(listener: (info: NetworkInfo) => void) {\n\n  const handleChange = () => {\n    listener(getNetworkInfo())\n  }\n\n  if ('connection' in navigator && isConnection(navigator.connection)) {\n    // 现代 Web API\n    let connection = navigator.connection;\n    connection.addEventListener('change', handleChange)\n    return () => connection.removeEventListener('change', handleChange);\n  } else {\n\n    window.addEventListener('online', handleChange)\n    window.addEventListener('offline', handleChange)\n    return () => {\n      window.removeEventListener('online', handleChange);\n      window.removeEventListener('offline', handleChange);\n    };\n  }\n}\n","// 可见性改变的监听器\nexport interface VisibilityChangeListener {\n  (hidden: boolean): void;\n}\n\n/**\n * 监听页面可见性变化（兼容旧的IE/Chrome）\n * @param listener 监听器\n * @returns 成功监听时返回解绑函数\n */\nexport function onVisibilityChange(listener: VisibilityChangeListener) {\n  let hiddenPropName: string | undefined = undefined,\n    hiddenEventName: string | undefined = undefined;\n\n  if (typeof document.hidden !== \"undefined\") {\n    // 现代 Web API\n    hiddenPropName = 'hidden';\n    hiddenEventName = 'visibilitychange'\n  } else if ('msHidden' in document && typeof document.msHidden !== \"undefined\") {\n    // 旧 IE\n    hiddenPropName = 'msHidden';\n    hiddenEventName = 'msvisibilitychange'\n  } else if ('webkitHidden' in document && typeof document.webkitHidden !== \"undefined\") {\n    // 旧 Chrome\n    hiddenPropName = 'webkitHidden';\n    hiddenEventName = 'webkitvisibilitychange'\n  }\n\n  if (!hiddenPropName || !hiddenEventName) {\n    return null;\n  }\n\n  const handler = () => {\n    // @ts-ignore\n    listener(document[hiddenPropName]);\n  };\n\n  document.addEventListener(hiddenEventName, handler);\n\n  return () => {\n    document.removeEventListener(hiddenEventName, handler);\n  };\n}\n\n"],"names":[],"mappings":"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"}

package/dist/types/error.d.ts

@@ -3,10 +3,11 @@
  */
 export declare class CommonError {
     message: string;
-    constructor(message: string);
+    error?: unknown;
+    constructor(message: string, error?: unknown);
 }
 /**
- * 终止异常
+ * 中止异常
  */
 export declare class AbortedError extends CommonError {
     constructor();

package/dist/utils/base-utils.d.ts

@@ -29,15 +29,15 @@ export declare class BaseUtils {
      * 格式化时间为 2020-02-02 20:20:20 的字符串
      * @param date 需要格式化的时间，为空则获取当前时间
      */
-    static getFormatedDateTime(date?: Date): string;
+    static getFormattedDateTime(date?: Date): string;
     /**
      * 格式化时间为 2020-02-02 的字符串
      * @param date 需要格式化的时间，为空则获取当前时间
      */
-    static getFormatedDate(date?: Date): string;
+    static getFormattedDate(date?: Date): string;
     /**
      * 格式化时间为 20:20:20 的字符串
      * @param date 需要格式化的时间，为空则获取当前时间
      */
-    static getFormatedTime(date?: Date): string;
+    static getFormattedTime(date?: Date): string;
 }

package/dist/utils/function-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 随机运行参数
+ * @param fns
+ * @param maxCount 最多执行次数（1 ~ fns.length）
+ */
+export declare function runRandomFunctions(fns: Array<() => void>, maxCount?: number): void;

package/dist/utils/network-utils.d.ts

@@ -0,0 +1,23 @@
+interface NetworkInformation extends EventTarget {
+    downlink: number;
+    rtt: number;
+    effectiveType: 'slow-2g' | '2g' | '3g' | '4g';
+}
+/**
+ * 网络状态信息
+ * - 'offline': 无网络
+ * - 'online': 在线但不支持 NetworkInformation API
+ * - NetworkInformation: 含详细网络信息
+ */
+export type NetworkInfo = 'offline' | Omit<NetworkInformation, keyof EventTarget> | 'online';
+/**
+ * 获取网络信息
+ */
+export declare function getNetworkInfo(): NetworkInfo;
+/**
+ * 监听网络状态变化
+ * @param listener 监听器
+ * @returns 成功监听时返回解绑函数
+ */
+export declare function onNetworkChange(listener: (info: NetworkInfo) => void): () => void;
+export {};

package/dist/utils/page-utils.d.ts

@@ -0,0 +1,9 @@
+export interface VisibilityChangeListener {
+    (hidden: boolean): void;
+}
+/**
+ * 监听页面可见性变化（兼容旧的IE/Chrome）
+ * @param listener 监听器
+ * @returns 成功监听时返回解绑函数
+ */
+export declare function onVisibilityChange(listener: VisibilityChangeListener): (() => void) | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ybgnb/utils",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "author": "hzhilong",
   "private": false,
   "description": "自用工具库",
@@ -18,9 +18,13 @@
     "dist"
   ],
   "scripts": {
+    "类型检查": "tsc --noEmit",
+    "代码检查": "eslint .",
     "build": "barrelsby -c barrelsby.json --delete --noHeader && vite build",
-    "npm login": " npm login",
-    "npm publish": " npm publish --access public"
+    "npm 登录": " npm login",
+    "npm 发布": " npm publish --access public",
+    "本地发布": "yalc publish",
+    "本地构建并发布": "barrelsby -c barrelsby.json --delete --noHeader && vite build --mode library && yalc publish"
   },
   "repository": {
     "type": "git",
@@ -37,8 +41,11 @@
   "homepage": "https://github.com/hzhilong/ybgnb-js#readme",
   "devDependencies": {
     "barrelsby": "^2.8.1",
-    "rimraf": "^5.0.5",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
     "typescript": "^5.8.3",
+    "typescript-eslint": "^8.43.0",
+    "jiti": "^2.5.1",
     "vite": "^7.1.5",
     "vite-plugin-dts": "^4.5.4"
   },