@ybgnb/utils 0.0.2 → 0.0.3

package/dist/index.d.ts

@@ -2,5 +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

@@ -109,6 +109,19 @@ 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;
 }
@@ -175,6 +188,7 @@ export {
   execBiz,
   getNetworkInfo,
   onNetworkChange,
-  onVisibilityChange
+  onVisibilityChange,
+  runRandomFunctions
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/utils/base-utils.ts","../src/types/error.ts","../src/utils/biz-result.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","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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"}
+{"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

@@ -112,6 +112,19 @@
       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;
   }
@@ -178,6 +191,7 @@
   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/utils/base-utils.ts","../src/types/error.ts","../src/utils/biz-result.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","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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"}
+{"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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ybgnb/utils",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "author": "hzhilong",
   "private": false,
   "description": "自用工具库",