@yh-kit/utils 1.2.2 → 1.3.1

package/dist/utils.js

@@ -1,29 +1,29 @@
-const o = (e) => {
-  if (!e || !e.length) return {};
-  const t = {};
-  return e.forEach((r) => {
+const i = (t) => {
+  if (!t || !t.length) return {};
+  const e = {};
+  return t.forEach((r) => {
     const n = Object.assign({ label: r.label, text: r.label }, r);
-    t[r == null ? void 0 : r.value] = n;
-  }), t;
-}, s = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+    e[r == null ? void 0 : r.value] = n;
+  }), e;
+}, u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toEnumObj: o
-}, Symbol.toStringTag, { value: "Module" })), d = {
-  ...s,
+  toEnumObj: i
+}, Symbol.toStringTag, { value: "Module" })), h = {
+  ...u,
   /**
    * 数组去重
    * @param arr 数组
    * @returns 去重后的数组
    */
-  unique: (e) => e ? Array.from(new Set(e)) : [],
+  unique: (t) => t ? Array.from(new Set(t)) : [],
   /**
    * 判断某元素是否在数组中
    * @param arr 数组
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  isExist(e, t) {
-    return !e || !t ? !1 : e.indexOf(t) !== -1;
+  isExist(t, e) {
+    return !t || !e ? !1 : t.indexOf(e) !== -1;
   },
   /**
    * 统计数组中某元素出现的次数：对于大型数组，手动循环的性能略优于 filter 和 reduce。
@@ -31,10 +31,10 @@ const o = (e) => {
    * @param target 目标元素
    * @returns 出现次数
    */
-  countOfAppear(e, t) {
+  countOfAppear(t, e) {
     let r = 0;
-    for (const n of e)
-      n === t && r++;
+    for (const n of t)
+      n === e && r++;
     return r;
   },
   /**
@@ -43,37 +43,352 @@ const o = (e) => {
    * @param order 排序方式：asc 升序；desc 降序
    * @returns 排序后的数组
    */
-  sort(e, t = "asc") {
-    return e ? e.sort((r, n) => t === "asc" ? r > n ? 1 : -1 : r < n ? 1 : -1) : [];
+  sort(t, e = "asc") {
+    return t ? t.sort((r, n) => e === "asc" ? r > n ? 1 : -1 : r < n ? 1 : -1) : [];
+  },
+  /**
+   * 数组乱序（洗牌算法）
+   * 1. 从数组的最后一个元素开始，将其与随机位置的元素交换位置。
+   * 2. 然后，从倒数第二个元素开始，将其与随机位置的元素交换位置。
+   * 3. 以此类推，直到第一个元素。
+   * 4. 这样，数组中的元素就会被随机打乱顺序。
+   * 5. 注意，这个算法会改变原数组。如果不想改变原数组，可以先复制一份再进行操作。
+   * 6. 时间复杂度：O(n)
+   * @param arr 数组
+   * @returns
+   */
+  shuffle(t) {
+    if (!t)
+      return [];
+    for (let e = t.length - 1; e > 0; e--) {
+      const r = Math.floor(Math.random() * (e + 1));
+      [t[e], t[r]] = [t[r], t[e]];
+    }
+    return t;
+  }
+}, y = {
+  /**
+   * 检查是否为空字符串
+   * @param str 要检查的字符串
+   * @returns 如果字符串为空，则返回 true，否则返回 false
+   */
+  isEmptyString(t) {
+    return typeof t == "string" && t.trim() === "";
+  },
+  /**
+   * 判断是否为数字
+   * @param val 要检查的值
+   * @returns 如果值是数字，则返回 true，否则返回 false
+   */
+  isNumber(t) {
+    return typeof t == "number" && !isNaN(t);
+  },
+  /**
+   * 判断是否为对象
+   * @param val 要检查的值
+   * @returns 如果值是对象，则返回 true，否则返回 false
+   */
+  isObject(t) {
+    return t !== null && typeof t == "object" && !Array.isArray(t);
+  },
+  /**
+   * 判断对象是否为空
+   * @param obj 要检查的对象
+   * @returns 如果对象为空，则返回 true，否则返回 false
+   */
+  isEmptyObject(t) {
+    return t ? Object.keys(t).length === 0 && t.constructor === Object : !0;
+  },
+  /**
+   * 判断是否为布尔值
+   * @param val 要检查的值
+   * @returns 如果值是布尔值，则返回 true，否则返回 false
+   */
+  isBoolean(t) {
+    return typeof t == "boolean";
+  },
+  /**
+   * 判断是否为数组
+   * @param val 要检查的值
+   * @returns 如果值是数组，则返回 true，否则返回 false
+   */
+  isArray(t) {
+    return Array.isArray(t);
+  },
+  /**
+   * 判断是否为函数
+   * @param val 要检查的值
+   * @returns
+   */
+  isFunction(t) {
+    return typeof t == "function";
+  },
+  /**
+   * 判断是否为 Promise 对象
+   * @param obj 要检查的对象
+   * @returns 如果对象是 Promise 对象，则返回 true，否则返回 false
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  isPromise(t) {
+    return !!t && (typeof t == "object" || typeof t == "function") && typeof t.then == "function";
+  },
+  /**
+   * 判断是否为 DOM 元素
+   * @param obj 要检查的对象
+   * @returns 如果对象是 DOM 元素，则返回 true，否则返回 false
+   */
+  isElement(t) {
+    return t instanceof Element;
+  },
+  /**
+   * 判断手机号格式（中国）
+   * @param str 手机号字符串
+   * @returns true 表示手机号格式正确，false 表示手机号格式错误
+   */
+  isPhone(t) {
+    return /^1[3-9]\d{9}$/.test(t);
+  },
+  /**
+   * 判断邮箱格式
+   * @param str 邮箱字符串
+   * @returns true 表示邮箱格式正确，false 表示邮箱格式错误
+   */
+  isEmail(t) {
+    return /^[\w.-]+@[\w.-]+\.\w+$/.test(t);
+  },
+  /**
+   * 判断字符串是否为 JSON
+   * @param str 字符串
+   * @returns true 表示是 JSON，false 表示不是 JSON
+   */
+  isJSON(t) {
+    try {
+      return JSON.parse(t), !0;
+    } catch {
+      return !1;
+    }
+  },
+  /**
+   * 判断图片是否加载完成
+   * @param img 图片对象
+   * @returns true 表示图片加载完成，false 表示图片未加载完成
+   * @example
+   * const img = new Image();
+   * img.src = "URL_ADDRESS   * img.src = "https://example.com/image.jpg";
+   */
+  isImageLoaded(t) {
+    return t.complete && t.naturalWidth !== 0;
+  },
+  /**
+   * 判断元素是否在可视区域内
+   * @param el 元素对象
+   * @returns true 表示元素在可视区域内，false 表示元素不在可视区域内
+   */
+  isInViewport(t) {
+    const e = t.getBoundingClientRect();
+    return e.top >= 0 && e.left >= 0 && e.bottom <= window.innerHeight && e.right <= window.innerWidth;
+  },
+  /**
+   * 判断是否为闰年
+   * @param year 年份
+   * @returns true 表示是闰年，false 表示不是闰年
+   * @example
+   * isLeapYear(2020); // true
+   * isLeapYear(2021); // false
+   * isLeapYear(2000); // true
+   * isLeapYear(1900); // false
+   * isLeapYear(2025); // false
+   * isLeapYear(2024); // true
+   */
+  isLeapYear(t) {
+    return t % 4 === 0 && t % 100 !== 0 || t % 400 === 0;
+  },
+  /**
+   * 判断是否为移动端
+   * @returns true 表示是移动端，false 表示不是移动端
+   */
+  isMobile() {
+    return /Mobi|Android|iPhone/i.test(navigator.userAgent);
+  }
+}, m = {
+  /**
+   * 通过传入的name获取cookie的值
+   * @param name cookie的name
+   * @returns cookie的值
+   */
+  getCookie(t) {
+    if (!t) return;
+    const e = document.cookie.match(new RegExp("(^| )" + t + "=([^;]+)"));
+    return e ? decodeURIComponent(e[2]) : null;
+  },
+  /**
+   * 设置 cookie
+   * @param name cookie的name
+   * @param value cookie的值
+   * @param days cookie的过期时间，默认7天。如果为0，则表示cookie在会话结束时过期。如果为负数，则表示cookie已过期。
+   * @returns void
+   */
+  setCookie(t, e, r = 7) {
+    const n = /* @__PURE__ */ new Date();
+    n.setTime(n.getTime() + r * 24 * 60 * 60 * 1e3), document.cookie = `${t}=${encodeURIComponent(e)};expires=${n.toUTCString()};path=/`;
+  },
+  /**
+   * 删除cookie
+   * @param name cookie的name
+   * @returns void
+   */
+  deleteCookie(t) {
+    this.setCookie(t, "", -1);
+  }
+}, b = {
+  /**
+   * 获取当前时间字符串
+   * @param locales 区域设置。如：'zh-CN'，'en-US'，"chinese"。默认'zh-CN'。
+   * @param hour12 是否使用12小时制。默认false，使用24小时制。
+   * @returns 当前时间的字符串。如：'2025/5/27 16:54:45'
+   */
+  getTimeString(t, e = !1) {
+    return e ? (/* @__PURE__ */ new Date()).toLocaleString(t, { hour12: !0 }) : (/* @__PURE__ */ new Date()).toLocaleString("chinese", { hour12: !1 });
+  },
+  /**
+   * 计算两个日期相差天数
+   * @param date1 日期1
+   * @param date2 日期2
+   * @returns 相差天数
+   */
+  diffDays(t, e) {
+    const r = new Date(t).getTime(), n = new Date(e).getTime();
+    return r > n ? Math.abs(Math.floor((r - n) / (24 * 3600 * 1e3))) : Math.abs(Math.floor((n - r) / (24 * 3600 * 1e3)));
+  },
+  /**
+   * 生成唯一ID（时间戳+随机数）
+   * @returns 唯一ID
+   */
+  uniqueId() {
+    return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
   }
-}, l = (e) => e > 25 || e < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[e], u = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+}, S = {
+  /**
+   * 将选中的字母数组从A-Z排序：用于试题选择答案的排序实例
+   * @param arr 字母数组
+   * @returns
+   */
+  sortFromA2Z: (t) => t != null && t.length ? t.sort((r, n) => {
+    const o = r.toUpperCase(), s = n.toUpperCase();
+    return o < s ? -1 : o > s ? 1 : 0;
+  }) : void 0
+}, c = (t) => t > 25 || t < 0 ? "" : "ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t], l = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toLetter: l
-}, Symbol.toStringTag, { value: "Module" })), c = (e) => e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), i = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  toLetter: c
+}, Symbol.toStringTag, { value: "Module" })), a = (t) => t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g, ","), f = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  toMoney: c
-}, Symbol.toStringTag, { value: "Module" })), g = {
-  ...u,
-  ...i
-}, b = {
+  toMoney: a
+}, Symbol.toStringTag, { value: "Module" })), O = {
+  ...l,
+  ...f,
+  /**
+   * 判断是否为数字
+   * @param val 待判断的值
+   * @returns 是否为数字。true 是；false 否
+   */
+  isNumber(t) {
+    return typeof t == "number" && !isNaN(t);
+  }
+}, w = {
+  /**
+   * 判断对象是否为空
+   * @param obj 对象
+   * @returns 是否为空。true 为空；false 不为空
+   */
+  isEmptyObject: (t) => t ? Object.keys(t).length === 0 && t.constructor === Object : !0
+}, U = {
   /**
    * 脱敏
    * @param phone 电话号码/手机号码
    * @returns 脱敏后的电话号码/手机号码
    */
-  desensitize: (e) => e ? e.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || e.slice(0, 3) + "****" + e.slice(7) : ""
-}, y = {
+  desensitize: (t) => t ? t.replace(/^(\d{3})\d{4}(\d{4})$/, "$1****$2") || t.slice(0, 3) + "****" + t.slice(7) : ""
+}, M = {
+  /**
+   * 生成随机颜色
+   * @returns 随机颜色值
+   */
+  color: () => `#${Math.random().toString(16).slice(2, 8)}`,
+  /**
+   * 生成指定范围的随机整数
+   * @param min 最小值
+   * @param max 最大值
+   * @returns 随机数
+   */
+  int(t, e) {
+    return Math.floor(Math.random() * (e - t + 1)) + t;
+  },
+  /**
+   * 生成唯一ID（时间戳+随机数）
+   * @returns 唯一ID
+   */
+  uniqueId() {
+    return Date.now().toString(36) + Math.random().toString(36).substr(2, 5);
+  }
+}, _ = {
+  /**
+   * 通过key值获取 localStorage 中存储的某个值
+   * @param key 获取的key
+   * @returns 获取的值
+   */
+  getLocal(t) {
+    return localStorage.getItem(t);
+  },
+  /**
+   * 设置localStorage中的某个值
+   * @param key 设置的key
+   * @param value 设置的value
+   */
+  setLocal(t, e) {
+    localStorage.setItem(t, e);
+  },
+  /**
+   * 删除localStorage中的某个值
+   * @param key 删除的key
+   */
+  removeLocal(t) {
+    localStorage.removeItem(t);
+  },
+  /**
+   * 通过key值获取 sessionStorage 中存储的某个值
+   * @param key 获取的key
+   * @returns 获取的值
+   */
+  getSession(t) {
+    return sessionStorage.getItem(t);
+  },
+  /**
+   * 设置sessionStorage中的某个值
+   * @param key 设置的key
+   * @param value 设置的value
+   */
+  setSession(t, e) {
+    sessionStorage.setItem(t, e);
+  },
+  /**
+   * 删除sessionStorage中的某个值
+   * @param key 删除的key
+   */
+  removeSession(t) {
+    sessionStorage.removeItem(t);
+  }
+}, j = {
   /**
    * 判断某元素是否在字符串中-比includes()方法更兼容，includes为ES6新增方法，IE不支持。小程序也不支持
    * @param str 字符串
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  isExist(e, t) {
-    if (!e || !t)
+  isExist(t, e) {
+    if (!t || !e)
       return !1;
-    const r = e.split(",");
-    return console.log("判断某元素是否在字符串中", r.indexOf(t) === -1), r.indexOf(t) !== -1;
+    const r = t.split(",");
+    return console.log("判断某元素是否在字符串中", r.indexOf(e) === -1), r.indexOf(e) !== -1;
   },
   /**
    * 判断某元素是否在字符串中-比isExist()方法更高效。
@@ -81,24 +396,72 @@ const o = (e) => {
    * @param element 查询元素
    * @returns 是否存在。true 存在；false 不存在
    */
-  includes(e, t) {
-    return !e || !t ? !1 : e.includes(t);
+  includes(t, e) {
+    return !t || !e ? !1 : t.includes(e);
+  },
+  /**
+   * 判断字符串是否为 JSON
+   * @param str 字符串
+   * @returns
+   */
+  isJSON(t) {
+    try {
+      return JSON.parse(t), !0;
+    } catch {
+      return !1;
+    }
   }
-}, f = (e) => {
-  const r = new RegExp("[?&]" + e + "=([^&#]*)", "i").exec(window.location.href);
+}, g = (t) => {
+  const r = new RegExp("[?&]" + t + "=([^&#]*)", "i").exec(window.location.href);
   return r ? decodeURIComponent(r[1]) : null;
-}, a = {
-  getQueryInfoByName: f
-}, p = {
-  ...a
-}, O = (e, t = 2) => {
-  console.log(e, t);
+};
+function d(t) {
+  return new URLSearchParams(window.location.search).get(t);
+}
+const p = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  getQueryInfoByName: g,
+  getQueryParam: d
+}, Symbol.toStringTag, { value: "Module" })), E = {
+  ...p,
+  /**
+   * 获取当前域名
+   * @returns 当前url链接的host信息
+   */
+  getHost() {
+    return window.location.host;
+  }
+}, I = {
+  /**
+   * 处理瀑布流数据，使其适合瀑布流布局展示
+   * @param list 瀑布流数据-数组
+   * @param columnsNum 需要展示的列数
+   * @returns 适合瀑布流布局的数组
+   */
+  toList: (t, e = 2) => {
+    console.log(t, e);
+    const r = {};
+    for (let o = 0; o < e; o++)
+      r[o] = [];
+    t.forEach((o, s) => r[s % e].push(o));
+    const n = [];
+    for (const o in r)
+      n.push(...r[o]);
+    return n;
+  }
 };
 export {
-  d as arrayUtils,
-  g as numberUtils,
-  b as phoneUtils,
-  y as stringUtils,
-  O as toList,
-  p as urlUtils
+  h as arrayUtils,
+  y as booleanUtils,
+  m as cookieUtils,
+  b as dateUtils,
+  S as letterUtils,
+  O as numberUtils,
+  w as objectUtils,
+  U as phoneUtils,
+  M as randomUtils,
+  _ as storageUtils,
+  j as stringUtils,
+  E as urlUtils,
+  I as waterfallUtils
 };

package/dist/utils.umd.cjs

@@ -1 +1 @@
-(function(r,s){typeof exports=="object"&&typeof module<"u"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(r=typeof globalThis<"u"?globalThis:r||self,s(r.yhkitUtils={}))})(this,function(r){"use strict";const i={...Object.freeze(Object.defineProperty({__proto__:null,toEnumObj:e=>{if(!e||!e.length)return{};const t={};return e.forEach(n=>{const o=Object.assign({label:n.label,text:n.label},n);t[n==null?void 0:n.value]=o}),t}},Symbol.toStringTag,{value:"Module"})),unique:e=>e?Array.from(new Set(e)):[],isExist(e,t){return!e||!t?!1:e.indexOf(t)!==-1},countOfAppear(e,t){let n=0;for(const o of e)o===t&&n++;return n},sort(e,t="asc"){return e?e.sort((n,o)=>t==="asc"?n>o?1:-1:n<o?1:-1):[]}},l={...Object.freeze(Object.defineProperty({__proto__:null,toLetter:e=>e>25||e<0?"":"ABCDEFGHIJKLMNOPQRSTUVWXYZ"[e]},Symbol.toStringTag,{value:"Module"})),...Object.freeze(Object.defineProperty({__proto__:null,toMoney:e=>e.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")},Symbol.toStringTag,{value:"Module"}))},u={desensitize:e=>e?e.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||e.slice(0,3)+"****"+e.slice(7):""},c={isExist(e,t){if(!e||!t)return!1;const n=e.split(",");return console.log("判断某元素是否在字符串中",n.indexOf(t)===-1),n.indexOf(t)!==-1},includes(e,t){return!e||!t?!1:e.includes(t)}},f={...{getQueryInfoByName:e=>{const n=new RegExp("[?&]"+e+"=([^&#]*)","i").exec(window.location.href);return n?decodeURIComponent(n[1]):null}}},d=(e,t=2)=>{console.log(e,t)};r.arrayUtils=i,r.numberUtils=l,r.phoneUtils=u,r.stringUtils=c,r.toList=d,r.urlUtils=f,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})});
+(function(o,s){typeof exports=="object"&&typeof module<"u"?s(exports):typeof define=="function"&&define.amd?define(["exports"],s):(o=typeof globalThis<"u"?globalThis:o||self,s(o.yhkitUtils={}))})(this,function(o){"use strict";const l={...Object.freeze(Object.defineProperty({__proto__:null,toEnumObj:t=>{if(!t||!t.length)return{};const e={};return t.forEach(r=>{const n=Object.assign({label:r.label,text:r.label},r);e[r==null?void 0:r.value]=n}),e}},Symbol.toStringTag,{value:"Module"})),unique:t=>t?Array.from(new Set(t)):[],isExist(t,e){return!t||!e?!1:t.indexOf(e)!==-1},countOfAppear(t,e){let r=0;for(const n of t)n===e&&r++;return r},sort(t,e="asc"){return t?t.sort((r,n)=>e==="asc"?r>n?1:-1:r<n?1:-1):[]},shuffle(t){if(!t)return[];for(let e=t.length-1;e>0;e--){const r=Math.floor(Math.random()*(e+1));[t[e],t[r]]=[t[r],t[e]]}return t}},c={isEmptyString(t){return typeof t=="string"&&t.trim()===""},isNumber(t){return typeof t=="number"&&!isNaN(t)},isObject(t){return t!==null&&typeof t=="object"&&!Array.isArray(t)},isEmptyObject(t){return t?Object.keys(t).length===0&&t.constructor===Object:!0},isBoolean(t){return typeof t=="boolean"},isArray(t){return Array.isArray(t)},isFunction(t){return typeof t=="function"},isPromise(t){return!!t&&(typeof t=="object"||typeof t=="function")&&typeof t.then=="function"},isElement(t){return t instanceof Element},isPhone(t){return/^1[3-9]\d{9}$/.test(t)},isEmail(t){return/^[\w.-]+@[\w.-]+\.\w+$/.test(t)},isJSON(t){try{return JSON.parse(t),!0}catch{return!1}},isImageLoaded(t){return t.complete&&t.naturalWidth!==0},isInViewport(t){const e=t.getBoundingClientRect();return e.top>=0&&e.left>=0&&e.bottom<=window.innerHeight&&e.right<=window.innerWidth},isLeapYear(t){return t%4===0&&t%100!==0||t%400===0},isMobile(){return/Mobi|Android|iPhone/i.test(navigator.userAgent)}},a={getCookie(t){if(!t)return;const e=document.cookie.match(new RegExp("(^| )"+t+"=([^;]+)"));return e?decodeURIComponent(e[2]):null},setCookie(t,e,r=7){const n=new Date;n.setTime(n.getTime()+r*24*60*60*1e3),document.cookie=`${t}=${encodeURIComponent(e)};expires=${n.toUTCString()};path=/`},deleteCookie(t){this.setCookie(t,"",-1)}},f={getTimeString(t,e=!1){return e?new Date().toLocaleString(t,{hour12:!0}):new Date().toLocaleString("chinese",{hour12:!1})},diffDays(t,e){const r=new Date(t).getTime(),n=new Date(e).getTime();return r>n?Math.abs(Math.floor((r-n)/(24*3600*1e3))):Math.abs(Math.floor((n-r)/(24*3600*1e3)))},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},d={sortFromA2Z:t=>t!=null&&t.length?t.sort((r,n)=>{const i=r.toUpperCase(),u=n.toUpperCase();return i<u?-1:i>u?1:0}):void 0},g={...Object.freeze(Object.defineProperty({__proto__:null,toLetter:t=>t>25||t<0?"":"ABCDEFGHIJKLMNOPQRSTUVWXYZ"[t]},Symbol.toStringTag,{value:"Module"})),...Object.freeze(Object.defineProperty({__proto__:null,toMoney:t=>t.toFixed(2).toString().replace(/\B(?=(\d{3})+(?!\d))/g,",")},Symbol.toStringTag,{value:"Module"})),isNumber(t){return typeof t=="number"&&!isNaN(t)}},y={isEmptyObject:t=>t?Object.keys(t).length===0&&t.constructor===Object:!0},m={desensitize:t=>t?t.replace(/^(\d{3})\d{4}(\d{4})$/,"$1****$2")||t.slice(0,3)+"****"+t.slice(7):""},b={color:()=>`#${Math.random().toString(16).slice(2,8)}`,int(t,e){return Math.floor(Math.random()*(e-t+1))+t},uniqueId(){return Date.now().toString(36)+Math.random().toString(36).substr(2,5)}},h={getLocal(t){return localStorage.getItem(t)},setLocal(t,e){localStorage.setItem(t,e)},removeLocal(t){localStorage.removeItem(t)},getSession(t){return sessionStorage.getItem(t)},setSession(t,e){sessionStorage.setItem(t,e)},removeSession(t){sessionStorage.removeItem(t)}},p={isExist(t,e){if(!t||!e)return!1;const r=t.split(",");return console.log("判断某元素是否在字符串中",r.indexOf(e)===-1),r.indexOf(e)!==-1},includes(t,e){return!t||!e?!1:t.includes(e)},isJSON(t){try{return JSON.parse(t),!0}catch{return!1}}},S=t=>{const r=new RegExp("[?&]"+t+"=([^&#]*)","i").exec(window.location.href);return r?decodeURIComponent(r[1]):null};function U(t){return new URLSearchParams(window.location.search).get(t)}const O={...Object.freeze(Object.defineProperty({__proto__:null,getQueryInfoByName:S,getQueryParam:U},Symbol.toStringTag,{value:"Module"})),getHost(){return window.location.host}},w={toList:(t,e=2)=>{console.log(t,e);const r={};for(let i=0;i<e;i++)r[i]=[];t.forEach((i,u)=>r[u%e].push(i));const n=[];for(const i in r)n.push(...r[i]);return n}};o.arrayUtils=l,o.booleanUtils=c,o.cookieUtils=a,o.dateUtils=f,o.letterUtils=d,o.numberUtils=g,o.objectUtils=y,o.phoneUtils=m,o.randomUtils=b,o.storageUtils=h,o.stringUtils=p,o.urlUtils=O,o.waterfallUtils=w,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yh-kit/utils",
   "private": false,
-  "version": "1.2.2",
+  "version": "1.3.1",
   "type": "module",
   "files": [
     "dist",

package/types/utils/lib/array/index.d.ts

@@ -29,5 +29,17 @@ export declare const arrayUtils: {
      * @returns 排序后的数组
      */
     sort<T>(arr: T[], order?: "asc" | "desc"): T[];
-    toEnumObj: (arr: import("@yh-kit/types").IOptionItem[]) => import("@yh-kit/types").TValueEnum;
+    /**
+     * 数组乱序（洗牌算法）
+     * 1. 从数组的最后一个元素开始，将其与随机位置的元素交换位置。
+     * 2. 然后，从倒数第二个元素开始，将其与随机位置的元素交换位置。
+     * 3. 以此类推，直到第一个元素。
+     * 4. 这样，数组中的元素就会被随机打乱顺序。
+     * 5. 注意，这个算法会改变原数组。如果不想改变原数组，可以先复制一份再进行操作。
+     * 6. 时间复杂度：O(n)
+     * @param arr 数组
+     * @returns
+     */
+    shuffle<T>(arr: T[]): T[];
+    toEnumObj: (arr: import("../../../typings/src").IOptionItem[]) => import("../../../typings/src").TValueEnum;
 };

package/types/utils/lib/boolean/index.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 布尔值相关工具函数
+ */
+export declare const booleanUtils: {
+    /**
+     * 检查是否为空字符串
+     * @param str 要检查的字符串
+     * @returns 如果字符串为空，则返回 true，否则返回 false
+     */
+    isEmptyString(str: string): boolean;
+    /**
+     * 判断是否为数字
+     * @param val 要检查的值
+     * @returns 如果值是数字，则返回 true，否则返回 false
+     */
+    isNumber<T>(val: T): boolean;
+    /**
+     * 判断是否为对象
+     * @param val 要检查的值
+     * @returns 如果值是对象，则返回 true，否则返回 false
+     */
+    isObject<T>(val: T): boolean;
+    /**
+     * 判断对象是否为空
+     * @param obj 要检查的对象
+     * @returns 如果对象为空，则返回 true，否则返回 false
+     */
+    isEmptyObject(obj: object): boolean;
+    /**
+     * 判断是否为布尔值
+     * @param val 要检查的值
+     * @returns 如果值是布尔值，则返回 true，否则返回 false
+     */
+    isBoolean<T>(val: T): val is T & boolean;
+    /**
+     * 判断是否为数组
+     * @param val 要检查的值
+     * @returns 如果值是数组，则返回 true，否则返回 false
+     */
+    isArray<T>(val: T): val is T & any[];
+    /**
+     * 判断是否为函数
+     * @param val 要检查的值
+     * @returns
+     */
+    isFunction<T>(val: T): val is T & Function;
+    /**
+     * 判断是否为 Promise 对象
+     * @param obj 要检查的对象
+     * @returns 如果对象是 Promise 对象，则返回 true，否则返回 false
+     */
+    isPromise(obj: any): boolean;
+    /**
+     * 判断是否为 DOM 元素
+     * @param obj 要检查的对象
+     * @returns 如果对象是 DOM 元素，则返回 true，否则返回 false
+     */
+    isElement<T>(obj: T): obj is T & Element;
+    /**
+     * 判断手机号格式（中国）
+     * @param str 手机号字符串
+     * @returns true 表示手机号格式正确，false 表示手机号格式错误
+     */
+    isPhone(str: string): boolean;
+    /**
+     * 判断邮箱格式
+     * @param str 邮箱字符串
+     * @returns true 表示邮箱格式正确，false 表示邮箱格式错误
+     */
+    isEmail(str: string): boolean;
+    /**
+     * 判断字符串是否为 JSON
+     * @param str 字符串
+     * @returns true 表示是 JSON，false 表示不是 JSON
+     */
+    isJSON(str: string): boolean;
+    /**
+     * 判断图片是否加载完成
+     * @param img 图片对象
+     * @returns true 表示图片加载完成，false 表示图片未加载完成
+     * @example
+     * const img = new Image();
+     * img.src = "URL_ADDRESS   * img.src = "https://example.com/image.jpg";
+     */
+    isImageLoaded(img: HTMLImageElement): boolean;
+    /**
+     * 判断元素是否在可视区域内
+     * @param el 元素对象
+     * @returns true 表示元素在可视区域内，false 表示元素不在可视区域内
+     */
+    isInViewport(el: HTMLElement): boolean;
+    /**
+     * 判断是否为闰年
+     * @param year 年份
+     * @returns true 表示是闰年，false 表示不是闰年
+     * @example
+     * isLeapYear(2020); // true
+     * isLeapYear(2021); // false
+     * isLeapYear(2000); // true
+     * isLeapYear(1900); // false
+     * isLeapYear(2025); // false
+     * isLeapYear(2024); // true
+     */
+    isLeapYear(year: number): boolean;
+    /**
+     * 判断是否为移动端
+     * @returns true 表示是移动端，false 表示不是移动端
+     */
+    isMobile(): boolean;
+};

package/types/utils/lib/cookie/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * cookie相关操作工具函数
+ */
+export declare const cookieUtils: {
+    /**
+     * 通过传入的name获取cookie的值
+     * @param name cookie的name
+     * @returns cookie的值
+     */
+    getCookie(name: string): string | null | undefined;
+    /**
+     * 设置 cookie
+     * @param name cookie的name
+     * @param value cookie的值
+     * @param days cookie的过期时间，默认7天。如果为0，则表示cookie在会话结束时过期。如果为负数，则表示cookie已过期。
+     * @returns void
+     */
+    setCookie(name: string, value: string | number | boolean, days?: number): void;
+    /**
+     * 删除cookie
+     * @param name cookie的name
+     * @returns void
+     */
+    deleteCookie(name: string): void;
+};

package/types/utils/lib/date/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 日期相关操作工具函数
+ */
+export declare const dateUtils: {
+    /**
+     * 获取当前时间字符串
+     * @param locales 区域设置。如：'zh-CN'，'en-US'，"chinese"。默认'zh-CN'。
+     * @param hour12 是否使用12小时制。默认false，使用24小时制。
+     * @returns 当前时间的字符串。如：'2025/5/27 16:54:45'
+     */
+    getTimeString(locales: "zh-CN", hour12?: boolean): string;
+    /**
+     * 计算两个日期相差天数
+     * @param date1 日期1
+     * @param date2 日期2
+     * @returns 相差天数
+     */
+    diffDays(date1: string, date2: string): number;
+    /**
+     * 生成唯一ID（时间戳+随机数）
+     * @returns 唯一ID
+     */
+    uniqueId(): string;
+};

package/types/utils/lib/index.d.ts

@@ -1,6 +1,13 @@
 export * from "./array";
+export * from "./boolean";
+export * from "./cookie";
+export * from "./date";
+export * from "./letter";
 export * from "./number";
+export * from "./object";
 export * from "./phone";
+export * from "./random";
+export * from "./storage";
 export * from "./string";
 export * from "./url";
 export * from "./waterfall";

package/types/utils/lib/number/index.d.ts

@@ -2,6 +2,12 @@
  * 数字相关操作工具函数
  */
 export declare const numberUtils: {
+    /**
+     * 判断是否为数字
+     * @param val 待判断的值
+     * @returns 是否为数字。true 是；false 否
+     */
+    isNumber<T>(val: T): boolean;
     toMoney: (x: number) => string;
     toLetter: (num: number) => string;
 };

package/types/utils/lib/object/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * object相关操作工具函数
+ */
+export declare const objectUtils: {
+    /**
+     * 判断对象是否为空
+     * @param obj 对象
+     * @returns 是否为空。true 为空；false 不为空
+     */
+    isEmptyObject: (obj: object) => boolean;
+};

package/types/utils/lib/random/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 随机数相关操作工具函数
+ */
+export declare const randomUtils: {
+    /**
+     * 生成随机颜色
+     * @returns 随机颜色值
+     */
+    color: () => string;
+    /**
+     * 生成指定范围的随机整数
+     * @param min 最小值
+     * @param max 最大值
+     * @returns 随机数
+     */
+    int(min: number, max: number): number;
+    /**
+     * 生成唯一ID（时间戳+随机数）
+     * @returns 唯一ID
+     */
+    uniqueId(): string;
+};

package/types/utils/lib/storage/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 本地存储相关操作工具函数
+ */
+export declare const storageUtils: {
+    /**
+     * 通过key值获取 localStorage 中存储的某个值
+     * @param key 获取的key
+     * @returns 获取的值
+     */
+    getLocal(key: string): string | null;
+    /**
+     * 设置localStorage中的某个值
+     * @param key 设置的key
+     * @param value 设置的value
+     */
+    setLocal(key: string, value: string): void;
+    /**
+     * 删除localStorage中的某个值
+     * @param key 删除的key
+     */
+    removeLocal(key: string): void;
+    /**
+     * 通过key值获取 sessionStorage 中存储的某个值
+     * @param key 获取的key
+     * @returns 获取的值
+     */
+    getSession(key: string): string | null;
+    /**
+     * 设置sessionStorage中的某个值
+     * @param key 设置的key
+     * @param value 设置的value
+     */
+    setSession(key: string, value: string): void;
+    /**
+     * 删除sessionStorage中的某个值
+     * @param key 删除的key
+     */
+    removeSession(key: string): void;
+};

package/types/utils/lib/string/index.d.ts

@@ -16,4 +16,10 @@ export declare const stringUtils: {
      * @returns 是否存在。true 存在；false 不存在
      */
     includes(str: string, element: string): boolean;
+    /**
+     * 判断字符串是否为 JSON
+     * @param str 字符串
+     * @returns
+     */
+    isJSON(str: string): boolean;
 };

package/types/utils/lib/url/index.d.ts

@@ -2,5 +2,11 @@
  * url链接信息相关操作工具函数
  */
 export declare const urlUtils: {
+    /**
+     * 获取当前域名
+     * @returns 当前url链接的host信息
+     */
+    getHost(): string;
+    getQueryParam(name: string): string | null;
     getQueryInfoByName: (name: string) => string | null;
 };

package/types/utils/lib/url/query.d.ts

@@ -1,4 +1,12 @@
-declare const _default: {
-    getQueryInfoByName: (name: string) => string | null;
-};
-export default _default;
+/**
+ * 通过传入字段名称获取 URL 查询参数
+ * @param name 字段名称
+ * @returns
+ */
+export declare const getQueryInfoByName: (name: string) => string | null;
+/**
+ * 通过传入字段名称 获取 URL 查询参数
+ * @param name 字段名称
+ * @returns
+ */
+export declare function getQueryParam(name: string): string | null;

package/types/utils/lib/waterfall/index.d.ts

@@ -1,7 +1,12 @@
 /**
- * 处理瀑布流数据，使其适合瀑布流布局展示
- * @param list 瀑布流数据-数组
- * @param columnsNum 需要展示的列数
- * @returns 适合瀑布流布局的数组
+ * 瀑布流相关操作工具函数
  */
-export declare const toList: (list: unknown[], columnsNum?: number) => void;
+export declare const waterfallUtils: {
+    /**
+     * 处理瀑布流数据，使其适合瀑布流布局展示
+     * @param list 瀑布流数据-数组
+     * @param columnsNum 需要展示的列数
+     * @returns 适合瀑布流布局的数组
+     */
+    toList: <T>(list: T[], columnsNum?: number) => any[];
+};