hy-app 0.3.16 → 0.4.0

package/utils/utils.ts

@@ -1,7 +1,7 @@
-import Base64 from './base64'
-import type { CSSProperties } from 'vue'
-import { isNumber } from './index'
-let base64: any = new Base64()
+import Base64 from "./base64";
+import type { CSSProperties } from "vue";
+import { error, isNumber } from "./index";
+let base64: any = new Base64();
 
 /**
  * 加密函数
@@ -9,7 +9,7 @@ let base64: any = new Base64()
  * @return { string } 加密字符串
  * */
 function encryptData(data: Record<string, any> | string): string {
-  return base64.encode(JSON.stringify(data))
+  return base64.encode(JSON.stringify(data));
 }
 
 /**
@@ -18,7 +18,7 @@ function encryptData(data: Record<string, any> | string): string {
  * @returns { any | any[] } 解码的数据
  * */
 function decryptData(encryptedVal: string): Record<string, any> {
-  return JSON.parse(base64.decode(encryptedVal.toString()))
+  return JSON.parse(base64.decode(encryptedVal.toString()));
 }
 
 /**
@@ -43,17 +43,20 @@ function decryptData(encryptedVal: string): Record<string, any> {
  * @param {String} unit 添加的单位名 比如px
  * @returns {String}
  */
-const addUnit = (value: string | number = 'auto', unit: string = ''): string => {
+const addUnit = (
+  value: string | number = "auto",
+  unit: string = "",
+): string => {
   if (!unit) {
-    unit = 'px'
+    unit = "px";
   }
-  if (unit == 'rpx' && isNumber(String(value))) {
-    value = Number(value) * 2
+  if (unit == "rpx" && isNumber(String(value))) {
+    value = Number(value) * 2;
   }
-  value = String(value)
+  value = String(value);
   // 用内置验证规则中的number判断是否为数值
-  return isNumber(value) ? `${value}${unit}` : value
-}
+  return isNumber(value) ? `${value}${unit}` : value;
+};
 
 /**
  * @description 日期的月或日补零操作
@@ -61,42 +64,42 @@ const addUnit = (value: string | number = 'auto', unit: string = ''): string =>
  * @returns {String}
  */
 const padZero = (value: string | number): string => {
-  return `00${value}`.slice(-2)
-}
+  return `00${value}`.slice(-2);
+};
 
 /**
  * @description 清空对象里面的值
  * @param val 任意类型的值
  * */
 const clearVal = (val: any) => {
-  const type = typeof val
-  const isArray = val instanceof Array
+  const type = typeof val;
+  const isArray = val instanceof Array;
   switch (type) {
-    case 'string':
-      return ''
-    case 'number':
-      return 0
-    case 'boolean':
-      return false
-    case 'undefined':
-      return null
-    case 'object':
-      if (!val) return null
+    case "string":
+      return "";
+    case "number":
+      return 0;
+    case "boolean":
+      return false;
+    case "undefined":
+      return null;
+    case "object":
+      if (!val) return null;
       if (isArray) {
         val.map((item) => {
-          clearVal(item)
-        })
-        return val
+          clearVal(item);
+        });
+        return val;
       } else {
         Object.keys(val).map((k) => {
-          val[k] = clearVal(val[k])
-        })
-        return val
+          val[k] = clearVal(val[k]);
+        });
+        return val;
       }
     default:
-      return ''
+      return "";
   }
-}
+};
 
 /**
  * 时间戳格式化
@@ -104,30 +107,36 @@ const clearVal = (val: any) => {
  * @param fmt 例:yyyy-MM-dd HH:mm:ss / yyyy-MM-dd
  * @return date 例:2023-12-09
  */
-const formatTime = (timestamp: number | string, fmt: string = 'yyyy-MM-dd HH:mm:ss'): string => {
-  let date: any
+const formatTime = (
+  timestamp: number | string,
+  fmt: string = "yyyy-MM-dd HH:mm:ss",
+): string => {
+  let date: any;
   if (timestamp) {
-    date = new Date(timestamp) ? new Date(timestamp) : timestamp
-    let ret
+    date = new Date(timestamp) ? new Date(timestamp) : timestamp;
+    let ret;
     const opt: any = {
-      'y+': date.getFullYear().toString(), //年
-      'M+': (date.getMonth() + 1).toString(), //月
-      'd+': date.getDate().toString(), //日
-      'H+': date.getHours().toString(), //时
-      'm+': date.getMinutes().toString(), //分
-      's+': date.getSeconds().toString(), //秒
+      "y+": date.getFullYear().toString(), //年
+      "M+": (date.getMonth() + 1).toString(), //月
+      "d+": date.getDate().toString(), //日
+      "H+": date.getHours().toString(), //时
+      "m+": date.getMinutes().toString(), //分
+      "s+": date.getSeconds().toString(), //秒
       //如果有其他格式字符需求可以继续添加，必须转化为字符串
-    }
+    };
     for (let k in opt) {
-      ret = new RegExp('(' + k + ')').exec(fmt)
+      ret = new RegExp("(" + k + ")").exec(fmt);
       if (ret) {
-        fmt = fmt.replace(ret[1], ret[1].length == 1 ? opt[k] : opt[k].padStart(ret[1].length, '0'))
+        fmt = fmt.replace(
+          ret[1],
+          ret[1].length == 1 ? opt[k] : opt[k].padStart(ret[1].length, "0"),
+        );
       }
     }
-    return fmt
+    return fmt;
   }
-  return date
-}
+  return date;
+};
 
 /**
  * @description 时间戳或年月日格式转为多久之前
@@ -139,51 +148,56 @@ const formatTime = (timestamp: number | string, fmt: string = 'yyyy-MM-dd HH:mm:
  */
 const formatTimeToString = (
   timestamp: string | number,
-  format: string | boolean = 'yyyy-mm-dd',
+  format: string | boolean = "yyyy-mm-dd",
 ): string => {
-  const now = new Date()
-  const oneYear = new Date(now.getFullYear(), 0, 1).getTime() // 当年一月一号时间戳
+  const now = new Date();
+  const oneYear = new Date(now.getFullYear(), 0, 1).getTime(); // 当年一月一号时间戳
 
-  if (timestamp == null) timestamp = Number(now)
-  timestamp = typeof timestamp === 'string' ? parseInt(timestamp) : new Date(timestamp).getTime()
+  if (timestamp == null) timestamp = Number(now);
+  timestamp =
+    typeof timestamp === "string"
+      ? parseInt(timestamp)
+      : new Date(timestamp).getTime();
   // 判断用户输入的时间戳是秒还是毫秒,一般前端js获取的时间戳是毫秒(13位),后端传过来的为秒(10位)
-  if (timestamp.toString().length == 10) timestamp *= 1000
-  let timer = now.getTime() - timestamp
-  timer = parseInt(String(timer / 1000))
+  if (timestamp.toString().length == 10) timestamp *= 1000;
+  let timer = now.getTime() - timestamp;
+  timer = parseInt(String(timer / 1000));
   // 如果小于5分钟,则返回"刚刚",其他以此类推
-  let tips = ''
+  let tips = "";
   switch (true) {
     case timer < 300:
-      tips = '刚刚'
-      break
+      tips = "刚刚";
+      break;
     case timer >= 300 && timer < 3600:
-      tips = `${parseInt(String(timer / 60))}分钟前`
-      break
+      tips = `${parseInt(String(timer / 60))}分钟前`;
+      break;
     case timer >= 3600 && timer < 86400:
-      tips = `${parseInt(String(timer / 3600))}小时前`
-      break
+      tips = `${parseInt(String(timer / 3600))}小时前`;
+      break;
     case timer >= 86400 && timer < 2592000:
-      tips = `${parseInt(String(timer / 86400))}天前`
-      break
+      tips = `${parseInt(String(timer / 86400))}天前`;
+      break;
     default:
       // 如果format为false，则无论什么时间戳，都显示xx之前
       if (format === false) {
         if (timer >= 2592000 && timer < 365 * 86400) {
-          tips = `${parseInt(String(timer / (86400 * 30)))}个月前`
+          tips = `${parseInt(String(timer / (86400 * 30)))}个月前`;
         } else {
-          tips = `${parseInt(String(timer / (86400 * 365)))}年前`
+          tips = `${parseInt(String(timer / (86400 * 365)))}年前`;
         }
       } else {
         if (timestamp > oneYear) {
-          formatTime(timestamp, 'MM-dd')
+          formatTime(timestamp, "MM-dd");
         } else {
           tips =
-            format === true ? formatTime(timestamp, 'yyyy-MM-dd') : formatTime(timestamp, format)
+            format === true
+              ? formatTime(timestamp, "yyyy-MM-dd")
+              : formatTime(timestamp, format);
         }
       }
   }
-  return tips
-}
+  return tips;
+};
 
 /**
  * @description 本地图片转base64方法（兼容APP、H5、小程序）
@@ -193,37 +207,37 @@ const formatTimeToString = (
 const imageToBase64 = (path: string) => {
   return new Promise((resolve, reject) => {
     // #ifdef APP-PLUS
-    plus.io.resolveLocalFileSystemURL(path, (entry) => {
-      entry.file((file) => {
-        let fileReader = new plus.io.FileReader()
-        fileReader.readAsDataURL(file)
-        fileReader.onloadend = (evt) => {
-          let base64 = evt.target.result.split(',')[1]
-          resolve(base64)
-        }
-      })
-    })
+    plus.io.resolveLocalFileSystemURL(path, (entry: any) => {
+      entry.file((file: any) => {
+        let fileReader = new plus.io.FileReader();
+        fileReader.readAsDataURL(file);
+        fileReader.onloadend = (evt: any) => {
+          let base64 = evt.target.result.split(",")[1];
+          resolve(base64);
+        };
+      });
+    });
     // #endif
     // #ifdef H5
     uni.request({
       url: path,
-      responseType: 'arraybuffer',
-      success: (res) => {
-        resolve(uni.arrayBufferToBase64(res.data))
+      responseType: "arraybuffer",
+      success: (res: UniApp.RequestSuccessCallbackResult) => {
+        resolve(uni.arrayBufferToBase64(res.data as ArrayBuffer));
       },
-    })
+    });
     // #endif
     // #ifdef MP-WEIXIN
     uni.getFileSystemManager().readFile({
       filePath: path,
-      encoding: 'base64',
+      encoding: "base64",
       success: (res) => {
-        resolve(res.data)
+        resolve(res.data);
       },
-    })
+    });
     // #endif
-  })
-}
+  });
+};
 
 /**
  * 函数防抖：一段实现执行多次，只执行最后一次
@@ -232,31 +246,31 @@ const imageToBase64 = (path: string) => {
  * @returns {void}
  * @constructor
  */
-let timeout: ReturnType<typeof setTimeout> | null = null
+let timeout: ReturnType<typeof setTimeout> | null = null;
 function debounce<T extends (...args: any[]) => void>(
   fn: T,
   wait: number = 500,
   immediate: boolean = false,
 ) {
   // 清除定时器
-  if (timeout !== null) clearTimeout(timeout)
+  if (timeout !== null) clearTimeout(timeout);
   // 立即执行，此类情况一般用不到
   if (immediate) {
-    const callNow = !timeout
+    const callNow = !timeout;
     timeout = setTimeout(() => {
-      timeout = null
-    }, wait)
-    if (callNow) typeof fn === 'function' && fn()
+      timeout = null;
+    }, wait);
+    if (callNow) typeof fn === "function" && fn();
   } else {
     // 设置定时器，当最后一次操作后，timeout不会再被清除，所以在延时wait毫秒后执行func回调方法
     timeout = setTimeout(() => {
-      typeof fn === 'function' && fn()
-    }, wait)
+      typeof fn === "function" && fn();
+    }, wait);
   }
 }
 
-let timer: ReturnType<typeof setTimeout> | null = null
-let flag: boolean | undefined
+let timer: ReturnType<typeof setTimeout> | null = null;
+let flag: boolean | undefined;
 /**
  * 函数节流: 一段时间执行一次
  * @param {void} fn 回调函数
@@ -265,25 +279,29 @@ let flag: boolean | undefined
  * @returns {void}
  * @constructor
  */
-const throttle = (fn: Function, wait: number = 500, immediate: boolean = true): void => {
+const throttle = (
+  fn: Function,
+  wait: number = 500,
+  immediate: boolean = true,
+): void => {
   if (immediate) {
     if (!flag) {
-      flag = true
+      flag = true;
       // 如果是立即执行，则在wait毫秒内开始时执行
-      typeof fn === 'function' && fn()
+      typeof fn === "function" && fn();
       timer = setTimeout(() => {
-        flag = false
-      }, wait)
+        flag = false;
+      }, wait);
     }
   } else if (!flag) {
-    flag = true
+    flag = true;
     // 如果是非立即执行，则在wait毫秒内的结束处执行
     timer = setTimeout(() => {
-      flag = false
-      typeof fn === 'function' && fn()
-    }, wait)
+      flag = false;
+      typeof fn === "function" && fn();
+    }, wait);
   }
-}
+};
 
 /**
  * 递归拷贝对象
@@ -291,19 +309,19 @@ const throttle = (fn: Function, wait: number = 500, immediate: boolean = true):
  * @returns 深拷贝的数组和对象
  * */
 const deepClone = (source: any) => {
-  if (!source && typeof source !== 'object') {
-    throw new Error('该值不存在或者不是个对象')
+  if (!source && typeof source !== "object") {
+    throw new Error("该值不存在或者不是个对象");
   }
-  const targetObj: any = source.constructor === Array ? [] : {}
+  const targetObj: any = source.constructor === Array ? [] : {};
   Object.keys(source).forEach((keys) => {
-    if (source[keys] && typeof source[keys] === 'object') {
-      targetObj[keys] = deepClone(source[keys])
+    if (source[keys] && typeof source[keys] === "object") {
+      targetObj[keys] = deepClone(source[keys]);
     } else {
-      targetObj[keys] = source[keys]
+      targetObj[keys] = source[keys];
     }
-  })
-  return targetObj
-}
+  });
+  return targetObj;
+};
 
 /**
  * 字节转化（b/KB/MB/GB）单位
@@ -311,16 +329,16 @@ const deepClone = (source: any) => {
  * @returns {string} 返回单位大小
  * */
 const bytesToSize = (bytes: number) => {
-  const sizes = ['b', 'KB', 'MB', 'GB', 'TB']
+  const sizes = ["b", "KB", "MB", "GB", "TB"];
   if (bytes === 0) {
-    return '0b'
+    return "0b";
   }
-  const i = Math.floor(Math.log(bytes) / Math.log(1024))
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
   if (i === 0) {
-    return `${bytes}${sizes[i]}`
+    return `${bytes}${sizes[i]}`;
   }
-  return `${(bytes / 1024 ** i).toFixed(1)}${sizes[i]}`
-}
+  return `${(bytes / 1024 ** i).toFixed(1)}${sizes[i]}`;
+};
 
 /**
  * @description 将对象转换为 URL 查询参数字符串
@@ -332,10 +350,10 @@ const objectToUrlParams = (params: Record<string, any>): string => {
     .filter(([key, value]) => value !== undefined && value !== null) // 过滤掉值为 undefined 或 null 的项
     .map(([key, value]) => {
       // 对值进行编码以确保 URL 安全
-      return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`
+      return `${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
     })
-    .join('&') // 使用 & 拼接所有参数
-}
+    .join("&"); // 使用 & 拼接所有参数
+};
 
 /**
  * 获取 [min,max]的随机数
@@ -345,23 +363,25 @@ const objectToUrlParams = (params: Record<string, any>): string => {
  * @returns {Number} string 随机数
  */
 const random = (min: number | string, max: number | string): number => {
-  min = Number(min)
-  max = Number(max)
-  return Math.floor(Math.random() * (max - min + 1) + min) ?? 0
-}
+  min = Number(min);
+  max = Number(max);
+  return Math.floor(Math.random() * (max - min + 1) + min) || 0;
+};
 
 const range = (min = 0, max = 0, value = 0) => {
-  return Math.max(min, Math.min(max, Number(value)))
-}
+  return Math.max(min, Math.min(max, Number(value)));
+};
 
-export type RectResultType<T extends boolean> = T extends true ? UniApp.NodeInfo[] : UniApp.NodeInfo
+export type RectResultType<T extends boolean> = T extends true
+  ? UniApp.NodeInfo[]
+  : UniApp.NodeInfo;
 /**
  * 查询节点信息
  * 目前此方法在支付宝小程序中无法获取组件跟接点的尺寸，为支付宝的bug(2020-07-21)
  * 解决办法为在组件根部再套一个没有任何作用的view元素
  * @param selector 元素类名或id
  * @param all 是否获取多个相同元素数值
- * @param ins 在微信小程序里，因为utils文件里面获取不到instance值所以必须通过ins这个传过来
+ * @param ins 在微信小程序里，因为utils文件里面获取不到instance值所以必须通过ins这个传过来【注意，（支付宝小程序无效）】
  * @param useFields 是否使用 fields 方法获取节点信息
  */
 const getRect = <T extends boolean>(
@@ -371,32 +391,35 @@ const getRect = <T extends boolean>(
   useFields?: boolean,
 ): Promise<RectResultType<T>> => {
   return new Promise<RectResultType<T>>((resolve, reject) => {
-    let query: UniNamespace.SelectorQuery | null = null
-    // TODO: 在微信小程序里，因为utils文件里面获取不到instance值所以必须通过ins这个传过来
+    let query: UniNamespace.SelectorQuery | null = null;
     if (ins) {
-      query = uni.createSelectorQuery().in(ins)
+      // TODO: 在微信小程序里，因为utils文件里面获取不到instance值所以必须通过ins这个传过来
+      query = uni.createSelectorQuery().in(ins);
     } else {
-      query = uni.createSelectorQuery()
+      query = uni.createSelectorQuery();
     }
-    const method = all ? 'selectAll' : 'select'
+    const method = all ? "selectAll" : "select";
 
     const callback = (rect: UniApp.NodeInfo | UniApp.NodeInfo[]) => {
       if (all && Array.isArray(rect) && rect.length > 0) {
-        resolve(rect as RectResultType<T>)
+        resolve(rect as RectResultType<T>);
       } else if (!all && rect) {
-        resolve(rect as RectResultType<T>)
+        resolve(rect as RectResultType<T>);
       } else {
-        reject(new Error('No nodes found'))
+        error("没找到模块");
+        reject(new Error("No nodes found"));
       }
-    }
+    };
 
     if (useFields) {
-      query[method](selector).fields({ size: true, node: true }, callback).exec()
+      query[method](selector)
+        .fields({ size: true, node: true }, callback)
+        .exec();
     } else {
-      query[method](selector).boundingClientRect(callback).exec()
+      query[method](selector).boundingClientRect(callback).exec();
     }
-  })
-}
+  });
+};
 
 /**
  * @description 用于获取用户传递值的px值  如果用户传递了"xxpx"或者"xxrpx"，取出其数值部分，如果是"xxxrpx"还需要用过uni.rpx2px进行转换
@@ -404,19 +427,21 @@ const getRect = <T extends boolean>(
  * @param {boolean} unit
  * @returns {number|string}
  */
-function getPx(value: string | number, unit: true): string
-function getPx(value: string | number, unit?: false): number
+function getPx(value: string | number, unit: true): string;
+function getPx(value: string | number, unit?: false): number;
 function getPx(value: string | number, unit: boolean = false): string | number {
-  if (isNumber(value) || typeof value === 'number') {
-    return unit ? `${value}px` : Number(value)
+  if (isNumber(value) || typeof value === "number") {
+    return unit ? `${value}px` : Number(value);
   }
   // 如果带有rpx，先取出其数值部分，再转为px值
   if (/(rpx|upx)$/.test(value)) {
-    return unit ? `${uni.rpx2px(parseInt(value))}px` : Number(uni.rpx2px(parseInt(value)))
+    return unit
+      ? `${uni.rpx2px(parseInt(value))}px`
+      : Number(uni.rpx2px(parseInt(value)));
   } else if (/(px)$/.test(value)) {
-    return unit ? value : Number(value.replace('px', ''))
+    return unit ? value : Number(value.replace("px", ""));
   } else {
-    return unit ? `${parseInt(value)}px` : Number(value)
+    return unit ? `${parseInt(value)}px` : Number(value);
   }
 }
 
@@ -426,8 +451,8 @@ function getPx(value: string | number, unit: boolean = false): string | number {
 const formatObject = (obj: CSSProperties) => {
   return Object.entries(obj)
     .map(([key, value]) => `${key.toUpperCase()}: ${value}`)
-    .join('; ')
-}
+    .join("; ");
+};
 
 export {
   encryptData,
@@ -448,4 +473,4 @@ export {
   getRect,
   getPx,
   formatObject,
-}
+};