@ybgnb/utils 0.0.5 → 0.0.7

package/dist/index.mjs

@@ -188,6 +188,29 @@ function shuffle(arr) {
   }
   return clone;
 }
+function randomInt(min, max) {
+  return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+function randomFloat(min, max) {
+  return Math.random() * (max - min) + min;
+}
+function sample(arr, count) {
+  return shuffle(arr).slice(0, count);
+}
+function sampleWithReplacement(arr, count) {
+  const result = [];
+  for (let i = 0; i < count; i++) {
+    const index = randomInt(0, arr.length - 1);
+    result.push(arr[index]);
+  }
+  return result;
+}
+function sampleOne(arr) {
+  return arr[randomInt(0, arr.length - 1)];
+}
+function random1ToN(n) {
+  return randomInt(1, n);
+}
 export {
   AbortedError,
   BaseUtils,
@@ -197,7 +220,12 @@ export {
   getNetworkInfo,
   onNetworkChange,
   onVisibilityChange,
+  random1ToN,
+  randomFloat,
   runRandomFunctions,
+  sample,
+  sampleOne,
+  sampleWithReplacement,
   shuffle
 };
 //# 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/function-utils.ts","../src/utils/network-utils.ts","../src/utils/page-utils.ts","../src/utils/random-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","/**\n * 数组洗牌\n */\nexport function shuffle<T>(arr: T[]): T[] {\n  const clone = arr.slice();\n  for (let i = clone.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [clone[i], clone[j]] = [clone[j], clone[i]];\n  }\n  return clone;\n}\n\n/**\n * 获取 [min, max] 的随机整数\n */\nfunction randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * 获取 [min, max) 的随机浮点数\n */\nfunction randomFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * 从数组中随机取若干项，不可重复\n */\nfunction sample<T>(arr: T[], count: number): T[] {\n  return shuffle(arr).slice(0, count);\n}\n\n/**\n * 从数组中随机取若干项，可重复\n */\nfunction sampleWithReplacement<T>(arr: T[], count: number): T[] {\n  const result: T[] = [];\n  for (let i = 0; i < count; i++) {\n    const index = randomInt(0, arr.length - 1);\n    result.push(arr[index]);\n  }\n  return result;\n}\n\n/**\n * 从数组中获取随机项\n */\nfunction sampleOne<T>(arr: T[]): T {\n  return arr[randomInt(0, arr.length - 1)];\n}\n\n/**\n * 获取 1~n 的随机数\n */\nfunction random1ToN(n: number): number {\n  return randomInt(1, 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","../src/utils/random-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","/**\n * 数组洗牌\n */\nexport function shuffle<T>(arr: T[]): T[] {\n  const clone = arr.slice();\n  for (let i = clone.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [clone[i], clone[j]] = [clone[j], clone[i]];\n  }\n  return clone;\n}\n\n/**\n * 获取 [min, max] 的随机整数\n */\nfunction randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * 获取 [min, max) 的随机浮点数\n */\nexport function randomFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * 从数组中随机取若干项，不可重复\n */\nexport function sample<T>(arr: T[], count: number): T[] {\n  return shuffle(arr).slice(0, count);\n}\n\n/**\n * 从数组中随机取若干项，可重复\n */\nexport function sampleWithReplacement<T>(arr: T[], count: number): T[] {\n  const result: T[] = [];\n  for (let i = 0; i < count; i++) {\n    const index = randomInt(0, arr.length - 1);\n    result.push(arr[index]);\n  }\n  return result;\n}\n\n/**\n * 从数组中获取随机项\n */\nexport function sampleOne<T>(arr: T[]): T {\n  return arr[randomInt(0, arr.length - 1)];\n}\n\n/**\n * 获取 1~n 的随机数\n */\nexport function random1ToN(n: number): number {\n  return randomInt(1, n);\n}\n"],"names":[],"mappings":"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"}

package/dist/index.umd.js

@@ -191,6 +191,29 @@
     }
     return clone;
   }
+  function randomInt(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+  }
+  function randomFloat(min, max) {
+    return Math.random() * (max - min) + min;
+  }
+  function sample(arr, count) {
+    return shuffle(arr).slice(0, count);
+  }
+  function sampleWithReplacement(arr, count) {
+    const result = [];
+    for (let i = 0; i < count; i++) {
+      const index = randomInt(0, arr.length - 1);
+      result.push(arr[index]);
+    }
+    return result;
+  }
+  function sampleOne(arr) {
+    return arr[randomInt(0, arr.length - 1)];
+  }
+  function random1ToN(n) {
+    return randomInt(1, n);
+  }
   exports2.AbortedError = AbortedError;
   exports2.BaseUtils = BaseUtils;
   exports2.BizResult = BizResult;
@@ -199,7 +222,12 @@
   exports2.getNetworkInfo = getNetworkInfo;
   exports2.onNetworkChange = onNetworkChange;
   exports2.onVisibilityChange = onVisibilityChange;
+  exports2.random1ToN = random1ToN;
+  exports2.randomFloat = randomFloat;
   exports2.runRandomFunctions = runRandomFunctions;
+  exports2.sample = sample;
+  exports2.sampleOne = sampleOne;
+  exports2.sampleWithReplacement = sampleWithReplacement;
   exports2.shuffle = shuffle;
   Object.defineProperty(exports2, Symbol.toStringTag, { value: "Module" });
 }));

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/function-utils.ts","../src/utils/network-utils.ts","../src/utils/page-utils.ts","../src/utils/random-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","/**\n * 数组洗牌\n */\nexport function shuffle<T>(arr: T[]): T[] {\n  const clone = arr.slice();\n  for (let i = clone.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [clone[i], clone[j]] = [clone[j], clone[i]];\n  }\n  return clone;\n}\n\n/**\n * 获取 [min, max] 的随机整数\n */\nfunction randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * 获取 [min, max) 的随机浮点数\n */\nfunction randomFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * 从数组中随机取若干项，不可重复\n */\nfunction sample<T>(arr: T[], count: number): T[] {\n  return shuffle(arr).slice(0, count);\n}\n\n/**\n * 从数组中随机取若干项，可重复\n */\nfunction sampleWithReplacement<T>(arr: T[], count: number): T[] {\n  const result: T[] = [];\n  for (let i = 0; i < count; i++) {\n    const index = randomInt(0, arr.length - 1);\n    result.push(arr[index]);\n  }\n  return result;\n}\n\n/**\n * 从数组中获取随机项\n */\nfunction sampleOne<T>(arr: T[]): T {\n  return arr[randomInt(0, arr.length - 1)];\n}\n\n/**\n * 获取 1~n 的随机数\n */\nfunction random1ToN(n: number): number {\n  return randomInt(1, 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","../src/utils/random-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","/**\n * 数组洗牌\n */\nexport function shuffle<T>(arr: T[]): T[] {\n  const clone = arr.slice();\n  for (let i = clone.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [clone[i], clone[j]] = [clone[j], clone[i]];\n  }\n  return clone;\n}\n\n/**\n * 获取 [min, max] 的随机整数\n */\nfunction randomInt(min: number, max: number): number {\n  return Math.floor(Math.random() * (max - min + 1)) + min;\n}\n\n/**\n * 获取 [min, max) 的随机浮点数\n */\nexport function randomFloat(min: number, max: number): number {\n  return Math.random() * (max - min) + min;\n}\n\n/**\n * 从数组中随机取若干项，不可重复\n */\nexport function sample<T>(arr: T[], count: number): T[] {\n  return shuffle(arr).slice(0, count);\n}\n\n/**\n * 从数组中随机取若干项，可重复\n */\nexport function sampleWithReplacement<T>(arr: T[], count: number): T[] {\n  const result: T[] = [];\n  for (let i = 0; i < count; i++) {\n    const index = randomInt(0, arr.length - 1);\n    result.push(arr[index]);\n  }\n  return result;\n}\n\n/**\n * 从数组中获取随机项\n */\nexport function sampleOne<T>(arr: T[]): T {\n  return arr[randomInt(0, arr.length - 1)];\n}\n\n/**\n * 获取 1~n 的随机数\n */\nexport function random1ToN(n: number): number {\n  return randomInt(1, n);\n}\n"],"names":[],"mappings":"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"}

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

@@ -2,3 +2,23 @@
  * 数组洗牌
  */
 export declare function shuffle<T>(arr: T[]): T[];
+/**
+ * 获取 [min, max) 的随机浮点数
+ */
+export declare function randomFloat(min: number, max: number): number;
+/**
+ * 从数组中随机取若干项，不可重复
+ */
+export declare function sample<T>(arr: T[], count: number): T[];
+/**
+ * 从数组中随机取若干项，可重复
+ */
+export declare function sampleWithReplacement<T>(arr: T[], count: number): T[];
+/**
+ * 从数组中获取随机项
+ */
+export declare function sampleOne<T>(arr: T[]): T;
+/**
+ * 获取 1~n 的随机数
+ */
+export declare function random1ToN(n: number): number;

package/package.json

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