jinbi-utils 1.0.19 → 1.0.21

package/src/common/index.ts

@@ -0,0 +1,353 @@
+/**
+ * 通用函数
+ * @packageDocumentation
+ * @module Common
+ * @preferred
+ */
+
+import {fromTypeMap, IFromType} from "@/constant/common.constant";
+
+/**
+ * 延迟函数（Promise 版本）
+ * @param ms - 延迟毫秒数
+ * @returns Promise
+ */
+export function delay(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * 检测设备是否为移动设备
+ * @returns 是否为移动设备
+ */
+export function deviceDetection(): boolean {
+  if (typeof window === 'undefined') return false;
+
+  const userAgent = navigator.userAgent.toLowerCase();
+  const isMidp = /midp/i.test(userAgent);
+  const isUcweb = /ucweb/i.test(userAgent);
+  const isAndroid = /android/i.test(userAgent);
+  const isIos = /iphone os/i.test(userAgent);
+  const isWinCe = /windows ce/i.test(userAgent);
+  const isWinMobile = /windows mobile/i.test(userAgent);
+  const isRv = /rv:1.2.3.4/i.test(userAgent);
+
+  return (
+    isMidp || isUcweb || isAndroid || isIos || isWinCe || isWinMobile || isRv
+  );
+}
+
+/**
+ * 判断val 是否是空值
+ #### 使用说明
+ ```
+ isEmpty('') 返回 true
+ isEmpty(null) 返回 true
+ isEmpty(undefined) 返回 true
+ isEmpty(12323) 返回 false
+ ```
+ */
+export function isEmpty(val: any): boolean {
+  return val === null || val === '' || val === undefined;
+}
+
+// from jinbizhihui
+
+
+// 获取环境变量
+// export const getEnvValue = (type: string) => {
+//   return import.meta.env[type]
+// }
+
+
+
+export const clearLoginData = () => {
+  // 这里做指定的 key 清除 是为了 避免 清除掉 jsapiticket 等一些需要有的字段 防止多次请求
+  localStorage.removeItem('wecom_userinfo')
+  localStorage.removeItem('wecom_token')
+  localStorage.removeItem('projectActive')
+  localStorage.removeItem('loginTime')
+  localStorage.removeItem('projectInfo')
+}
+
+// 获取url中参数
+export const getQueryString = (url: string, queryKey: string) => {
+  const reg = new RegExp(`&{1}${queryKey}\\=[a-zA-Z0-9_-]+`, 'g')
+  const matchResult = url.replace(/\?/g, '&').match(reg)![0]
+  return matchResult.substr(matchResult.indexOf('=') + 1)
+}
+
+export const getQueryVariable = (variable) => {
+  var query = window.location.search.substring(1)
+  var vars = query.split('&')
+  for (var i = 0; i < vars.length; i++) {
+    var pair = vars[i].split('=')
+    if (pair[0] === variable) { return pair[1] }
+  }
+  return (false)
+}
+
+export const getWecomToken = () => {
+  return localStorage.getItem('wecom_token')
+}
+// 判断设备类型
+export const getDeviceType = (): IFromType => {
+  const ua = navigator.userAgent.toLowerCase();
+  const isWxWork = /wxwork/.test(ua); // 企业微信
+  const isWeixin = /micromessenger/.test(ua) && !isWxWork; // 微信，排除企业微信
+
+  // 使用屏幕宽度判断是否移动设备
+  const isMobileScreen = window.innerWidth <= 768;
+
+  return {
+    isWxWork,
+    isWeixin,
+    isMobileScreen,
+    isMobileAny: isWxWork || isWeixin || isMobileScreen,
+  };
+};
+
+export const getFromType = (res: IFromType) => {
+  let result = 'wecom'
+  for( let key in res) {
+    const value = res[key]
+    if (value) {
+      result = fromTypeMap[key]
+      break;
+    }
+  }
+  return result;
+}
+export function randomString(e) {
+  e = e || 32
+  let t = 'ABCDEFGHJKMNPQRSTWXYZabcdefhijkmnprstwxyz2345678'
+  let a = t.length
+  let n = ''
+  for (let i = 0; i < e; i++) n += t.charAt(Math.floor(Math.random() * a))
+  return n
+}
+export const getCookie = (cookieName) => {
+  let cookie = ''
+  let cookieArr = document.cookie.split('; ')
+  for (let i = 0; i < cookieArr.length; i++) {
+    var valueArr = cookieArr[i].split('=')
+    if (valueArr[0] === cookieName) {
+      cookie = valueArr[1]
+      break
+    }
+  }
+  return cookie
+}
+// || 'cc51882c781d8035b98335ccb44787b42dd9d91ba3b85a45ff3e867857a526bfbbddcdc27b8edce9a52882d1838e0b8e6ccf658ed105df9a898b1c977c588bd1'
+export const buildUUID = () => {
+  const hexList: string[] = []
+  for (let i = 0; i <= 15; i++) {
+    hexList[i] = i.toString(16) as string
+  }
+  let uuid = ''
+  for (let i = 1; i <= 36; i++) {
+    if (i === 9 || i === 14 || i === 19 || i === 24) {
+      uuid += '-'
+    } else if (i === 15) {
+      uuid += 4
+    } else if (i === 20) {
+      uuid += hexList[(Math.random() * 4) | 8];
+    } else {
+      uuid += hexList[(Math.random() * 16) | 0];
+    }
+  }
+  return uuid.replace(/-/g, '')
+}
+
+export const getTicket = () => {
+  return localStorage.getItem('jsapiTicket')
+}
+export const setTicket = (jsapiTicket) => {
+  return localStorage.setItem('jsapiTicket', jsapiTicket)
+}
+export const removeTicket = () => {
+  return localStorage.removeItem('jsapiTicket')
+}
+
+
+export const formateTimestamp = (timestamp: number | null, type = 'YYYY年MM月DD日 hh:mm:ss') => {
+  if (!timestamp) {
+    return '-'
+  }
+  const date = new Date(timestamp)
+  const year = date.getFullYear() + ''
+  const month = date.getMonth() + 1
+  const day = date.getDate()
+  const houre = date.getHours() > 9 ? date.getHours() : '0' + date.getHours()
+  const minute = date.getMinutes() > 9 ? date.getMinutes() : '0' + date.getMinutes()
+  const second = date.getSeconds() > 9 ? date.getSeconds() : '0' + date.getSeconds()
+  const result = type.replace('YYYY', year + '').replace('MM', month + '').replace('DD', day + '').replace('hh', houre + '').replace('mm', minute + '').replace('ss', second + '')
+  return result
+
+}
+
+
+export const convertBase64UrlToBlob = (urlData) => {
+  // console.log('urlData', urlData)
+  // 将以base64的图片url数据转换为Blob
+  var bytes = window.atob(urlData.split(',')[1]) // 去掉url的头，并转换为byte
+  // 处理异常,将ascii码小于0的转换为大于0
+  var ab = new ArrayBuffer(bytes.length)
+  var ia = new Uint8Array(ab)
+  for (var i = 0; i < bytes.length; i++) {
+    ia[i] = bytes.charCodeAt(i)
+  }
+  return new Blob([ab], { type: 'image/png' })
+}
+
+
+export const getEnvironment = () => {
+  const isMobile = window.navigator.userAgent.match(/(phone|pad|pod|iPhone|iPod|ios|iPad|Android|Mobile|BlackBerry|IEMobile|MQQBrowser|JUC|Fennec|wOSBrowser|BrowserNG|WebOS|Symbian|Windows Phone)/i); // 是否手机端
+  const isWx = /micromessenger/i.test(navigator.userAgent); // 是否微信
+  const isComWx = /wxwork/i.test(navigator.userAgent); // 是否企业微信
+
+  if (isComWx && isMobile) { //手机端企业微信
+    return 'com-wx-mobile'
+  }
+  else if (isComWx && !isMobile) { //PC端企业微信
+    return 'com-wx-pc'
+  }
+  else if (isWx && isMobile) { // 手机端微信
+    return 'wx-mobile';
+  }
+  else if (isWx && !isMobile) { // PC端微信
+    return 'wx-pc';
+  }
+  else {
+    return 'other';
+  }
+}
+
+export const getIsComWx = () => {
+  const isComWx = /wxwork/i.test(navigator.userAgent); // 是否企业微信
+  return isComWx
+}
+export const getIsDevelopment = () => {
+  let result = false
+  if (location.origin === 'uat2-h5-wecom.hengdayun.com' || location.origin === '127.0.0.1:8081' || location.origin === 'localhost:8081') {
+    result = true
+  }
+
+  return result
+}
+// 处理时间，企微不能通过dayjs以及moment处理时间
+
+// 过滤数组重复数据
+export const filterRepeat = (arr: any[], fieldName: string) => {
+  const set = new Set()
+  return arr.filter(item => {
+    const key = item[fieldName]
+    if (set.has(key)) {
+      return false
+    } else {
+      set.add(key)
+      return true
+    }
+  })
+}
+
+// 将 base64 转换为 Blob
+export const base64ToBlob = (base64) => {
+  var arr = base64.split(","),
+    mime = arr[0].match(/:(.\*?);/)[1],
+    bstr = atob(arr[1]),
+    n = bstr.length,
+    u8arr = new Uint8Array(n);
+  while (n--) {
+    u8arr[n] = bstr.charCodeAt(n);
+  }
+  return new Blob([u8arr], {
+    type: mime,
+  });
+}
+// 将 base64 转换为 File
+export const base64ToFile = (base64, fileName) => {
+  let arr = base64.split(",");
+  let mime = arr[0].match(/:(.*);/)[1];
+
+  let bstr = atob(arr[1]);
+  let n = bstr.length;
+  let u8arr = new Uint8Array(n);
+
+  while (n--) {
+    u8arr[n] = bstr.charCodeAt(n);
+  }
+  return new File([u8arr], fileName, { type: mime });
+}
+
+// 处理时间，企微不能通过dayjs以及moment处理时间
+export const isImage = (type: string) => {
+  return /^image\//i.test(type);
+}
+
+// 获取文件数据
+export const getFileData = (optionName: string) => {
+  const [name = '', url = ''] = optionName.split(',')
+  return {
+    name: decodeURIComponent(name),
+    url: decodeURIComponent(url)
+  }
+}
+// 验证是否为数字
+export const validateTwoDecimal = (v: number | string) => {
+  if (!v || v === '') return true
+  return /^(\d+)(\.\d{1,2})?$/.test(v.toString())
+}
+// 生成uuid
+export const uuid = (len, radix) => {
+  let chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('');
+  let uuid: string[] = [], i: string | number;
+  radix = radix || chars.length;
+
+  if (len) {
+    // Compact form
+    for (i = 0; i < len; i++) uuid[i] = chars[0 | Math.random() * radix];
+  } else {
+    // rfc4122, version 4 form
+    let r;
+
+    // rfc4122 requires these characters
+    uuid[8] = uuid[13] = uuid[18] = uuid[23] = '-';
+    uuid[14] = '4';
+
+    // Fill in random data.  At i==19 set the high bits of clock sequence as
+    // per rfc4122, sec. 4.1.5
+    for (i = 0; i < 36; i++) {
+      if (!uuid[i]) {
+        r = 0 | Math.random() * 16;
+        uuid[i] = chars[(i == 19) ? (r & 0x3) | 0x8 : r];
+      }
+    }
+  }
+
+  return uuid.join('');
+}
+
+export const getToken = (cacheType: string, key = 'token') => {
+  let token = ''
+  const cacheTypeToLower = cacheType.toLowerCase();
+  if (cacheTypeToLower === 'localstorage') {
+    token = localStorage.getItem(key) || '';
+  } else if (cacheTypeToLower === 'sessionstorage') {
+    token = sessionStorage.getItem(key) || '';
+  } else {
+    token = localStorage.getItem(key) || sessionStorage.getItem('token') || '';
+  }
+  return token;
+}
+export const removeToken = (cacheType: string, key = 'token') => {
+  const cacheTypeToLower = cacheType.toLowerCase();
+  if (cacheTypeToLower === 'localstorage') {
+    localStorage.removeItem(key);
+  } else if (cacheTypeToLower === 'sessionstorage') {
+    sessionStorage.removeItem(key);
+  } else {
+    localStorage.removeItem(key);
+    sessionStorage.removeItem(key);
+  }
+}

package/src/constant/common.constant.ts

@@ -0,0 +1,13 @@
+// 判断设备类型
+export interface IFromType {
+  isWxWork: boolean;
+  isWeixin: boolean;
+  isMobileScreen: boolean;
+  isMobileAny: boolean;
+}
+export const fromTypeMap = {
+  isWxWork: 'wecom',
+  isWeixin: 'wechat',
+  isMobile: 'mobile',
+  isMobileAny: 'mobile',
+}

package/src/date/index.ts

@@ -0,0 +1,143 @@
+/**
+ * 时间处理相关
+ * @packageDocumentation
+ * @module Date
+ * @preferred
+ */
+import { isEmpty } from '../common';
+
+/**
+ * 解决ios不支持 new Date('2020-02-02')问题
+ #### 使用说明
+ ```
+  compatibleDate('2020-03-04') 返回 2020/03/04
+  compatibleDate(Date.now()) 返回 Date.now()
+  compatibleDate(new Date()) 返回 new Date()
+  ```
+ */
+export function compatibleDate(date: string | number | Date) {
+  if (typeof date === 'string') {
+    return date.replace(/-/g, '/');
+  }
+  return date;
+}
+
+/**
+ * 调用原生 new Date 返回 Date实例 解决ios不支持 yyyy-MM-dd HH:mm:ss 格式new Date
+ #### 使用说明
+ ```
+  newDate() 返回 new Date()
+  newDate('2020-03-04') 返回 new Date('2020-03-04')
+  ```
+ */
+export function newDate(date?: string | number | Date): Date {
+  if (!date) return new Date();
+  return new Date(compatibleDate(date));
+}
+
+/**
+ * 格式化时间
+ #### 使用说明
+ ```
+ formatTime() 返回 yyyy-MM-dd HH:mm:ss 格式的当前时间
+ formatTime('2018-02-02 00:00:00') 返回 2018-02-02 00:00:00
+ formatTime('2018-02-02', 'yyyy/MM/dd') 返回 2018/02/02
+ formatTime('2018-02-02 23:50:50', 'yyyy/MM/dd HH:mm:ss') 返回 2018/02/02 23:50:50
+ formatTime('2018-02-02 23:50:50', 'MM/dd HH:mm:ss') 返回 02/02 23:50:50
+ formatTime(new Date('2018-02-02 23:50:50') + 200, 'yyyy/MM/dd HH:mm:ss S') 返回 2018/02/02 23:50:50 200
+ ```
+ */
+export function formatTime(date: string | number | Date = Date.now(), fmt = 'yyyy-MM-dd HH:mm:ss') {
+  date = compatibleDate(date);
+
+  date = new Date(date);
+  const o: any = {
+    'M+': date.getMonth() + 1, // 月份
+    'd+': date.getDate(), // 日
+    'h+': date.getHours() % 12 === 0 ? 12 : date.getHours() % 12, // 小时
+    'H+': date.getHours(), // 小时
+    'm+': date.getMinutes(), // 分
+    's+': date.getSeconds(), // 秒
+    'q+': Math.floor((date.getMonth() + 3) / 3), // 季度
+    S: date.getMilliseconds(), // 毫秒
+  };
+
+  if (/(y+)/.test(fmt)) {
+    fmt = fmt.replace(RegExp.$1, (`${date.getFullYear()}`).substr(4 - RegExp.$1.length));
+  }
+
+  Object.keys(o).forEach((k) => {
+    if (new RegExp(`(${k})`).test(fmt)) {
+      fmt = fmt.replace(RegExp.$1, (RegExp.$1.length === 1) ? (o[k]) : ((`00${o[k]}`).substr((`${o[k]}`).length)));
+    }
+  });
+
+  return fmt;
+}
+
+/**
+ * 格式化相对时间
+ #### 使用说明
+ ```
+ fromNow('') 返回 -
+ fromNow(Date.now() - 2000) 返回 刚刚
+ fromNow(now - 3420 * 1000) 返回 58分钟前面
+ fromNow(now - 3600 * 1000 * 3) 返回 3小时前
+ fromNow(now - 3600 * 1000 * 24 * 1.5) 返回 1天前
+ fromNow(now - day5) 返回 当前时间的5天前日期 格式 yyyy年MM月dd日 HH时mm分ss秒
+ fromNow(Date.now() + 2000) 返回 Date.now() + 2000
+ fromNow('', '', 'defaultValue') 等于 defaultValue
+ ```
+ */
+export function fromNow(time: Date | string | number, fmt: string = 'yyyy年MM月dd日 HH时mm分ss秒', defaultValue = '-') {
+  if (isEmpty(time)) {
+    return defaultValue;
+  }
+  time = compatibleDate(time);
+  const d = new Date(time);
+  const now = Date.now();
+  const diff = (now - d.getTime()) / 1000;
+  if (diff < 0) {
+    return time;
+  }
+
+  if (diff < 30) {
+    return '刚刚';
+  }
+  if (diff < 3600) {
+    return `${Math.ceil(diff / 60)}分钟前`;
+  }
+  if (diff < 3600 * 24) {
+    return `${Math.floor(diff / 3600)}小时前`;
+  }
+  if (diff < 3600 * 24 * 2) {
+    return '1天前';
+  }
+
+  return formatTime(time, fmt);
+}
+
+/**
+ * 增加日期天数
+ #### 使用说明
+ ```
+ addDays('') 返回 -
+ addDays('2018-02-02') 返回 2018-02-02
+ addDays('2018-02-02', 2) 返回 2018-02-04
+ addDays('2018-02-02', 2, 'yyyy/MM/dd') 返回 2018/02/04
+ addDays(new Date('2020-03-04'), 2, 'yyyy/MM/dd') 返回 2020/03/06
+ addDays(Date.now(), 2, 'yyyy/MM/dd') 返回 今天 + 2天
+ ```
+ */
+export function addDays(date: Date | string | number, days: string | number = 0, fmt: string = 'yyyy-MM-dd') {
+  if (isEmpty(date)) {
+    return '-';
+  }
+  date = compatibleDate(date);
+  const d = new Date(date);
+  d.setDate(d.getDate() + Number(days));
+
+  return formatTime(d, fmt);
+}
+
+// 获取当前时间月份

package/src/dom/index.ts

@@ -0,0 +1,198 @@
+/**
+ * DOM 操作相关
+ * @packageDocumentation
+ * @module DOM
+ * @preferred
+ */
+
+/**
+ * 检查元素是否包含指定的 class
+ * @param el - DOM 元素
+ * @param cls - class 名称
+ * @returns 是否包含该 class
+ */
+export function hasClass(el: Element | null, cls: string): boolean {
+  if (typeof window === 'undefined' || !el) return false;
+  return !!el.className.match(new RegExp('(\\s|^)' + cls + '(\\s|$)'));
+}
+
+/**
+ * 添加 class 到元素
+ * @param el - DOM 元素
+ * @param cls - class 名称
+ */
+export function addClass(el: Element | null, cls: string): void {
+  if (typeof window === 'undefined' || !el) return;
+  if (!hasClass(el, cls)) {
+    el.className += ' ' + cls;
+  }
+}
+
+/**
+ * 从元素移除 class
+ * @param el - DOM 元素
+ * @param cls - class 名称
+ */
+export function removeClass(el: Element | null, cls: string): void {
+  if (typeof window === 'undefined' || !el) return;
+  if (hasClass(el, cls)) {
+    const reg = new RegExp('(\\s|^)' + cls + '(\\s|$)');
+    el.className = el.className.replace(reg, ' ').trim();
+  }
+}
+
+/**
+ * 切换元素的 class
+ * @param flag - 是否添加 class
+ * @param clsName - class 名称
+ * @param target - 目标元素，默认为 document.body
+ */
+export function toggleClass(
+  flag: boolean,
+  clsName: string,
+  target?: HTMLElement
+): void {
+  if (typeof window === 'undefined') return;
+
+  const targetEl = target || document.body;
+  let { className } = targetEl;
+  className = className.replace(clsName, '').trim();
+  targetEl.className = flag ? `${className} ${clsName}`.trim() : className;
+}
+
+/**
+ * 打开链接
+ * @param url - URL 地址
+ * @param target - 打开方式，默认 "_blank"
+ */
+export function openLink(url: string, target: string = '_blank'): void {
+  if (typeof window === 'undefined') return;
+
+  const link = document.createElement('a');
+  link.setAttribute('href', url);
+  link.setAttribute('target', target);
+  link.setAttribute('rel', 'noreferrer noopener');
+  link.setAttribute('id', 'external');
+
+  const existingLink = document.getElementById('external');
+  if (existingLink) {
+    document.body.removeChild(existingLink);
+  }
+
+  document.body.appendChild(link);
+  link.click();
+  link.remove();
+}
+
+/**
+ * 复制文本到剪贴板
+ * @param text - 要复制的文本
+ * @returns 是否复制成功
+ */
+export function copyTextToClipboard(text: string): boolean {
+  if (typeof window === 'undefined' || typeof document === 'undefined') {
+    return false;
+  }
+
+  // 创建临时文本框
+  const textarea = document.createElement('textarea');
+  const activeElement = document.activeElement as HTMLElement;
+
+  textarea.value = text;
+  textarea.setAttribute('readonly', '');
+  textarea.style.position = 'absolute';
+  textarea.style.left = '-9999px';
+  textarea.style.fontSize = '12pt';
+  textarea.style.border = '0';
+  textarea.style.padding = '0';
+  textarea.style.margin = '0';
+
+  // 保存当前选区
+  const selection = document.getSelection();
+  let originalRange: Range | null = null;
+  if (selection && selection.rangeCount > 0) {
+    originalRange = selection.getRangeAt(0);
+  }
+
+  // 添加到 DOM 并选中
+  document.body.appendChild(textarea);
+  textarea.select();
+  textarea.selectionStart = 0;
+  textarea.selectionEnd = text.length;
+
+  // 执行复制
+  let success = false;
+  try {
+    success = document.execCommand('copy');
+  } catch (err) {
+    console.error('复制失败:', err);
+  }
+
+  // 清理
+  textarea.remove();
+
+  // 恢复原选区
+  if (originalRange && selection) {
+    selection.removeAllRanges();
+    selection.addRange(originalRange);
+  }
+
+  // 恢复焦点
+  if (activeElement) {
+    activeElement.focus();
+  }
+
+  return success;
+}
+
+/**
+ * SVG 信息接口
+ */
+export interface SvgInfo {
+  width: number;
+  height: number;
+  body: string;
+}
+
+/**
+ * 解析 SVG 字符串，提取宽度、高度和 body 内容
+ * @param svg - SVG 字符串
+ * @returns SVG 信息对象或原字符串
+ */
+export function getSvgInfo(svg: string): SvgInfo | string {
+  if (typeof window === 'undefined' || typeof DOMParser === 'undefined') {
+    return svg;
+  }
+
+  try {
+    const parser = new DOMParser();
+    const doc = parser.parseFromString(svg, 'image/svg+xml');
+    const svgElement = doc.querySelector('svg');
+
+    if (!svgElement) {
+      return svg;
+    }
+
+    const viewBox = svgElement.getAttribute('viewBox');
+    if (!viewBox) {
+      throw new Error('Invalid SVG string: Missing viewBox attribute.');
+    }
+
+    const viewBoxParts = viewBox.split(' ');
+    const width = parseInt(viewBoxParts[2], 10);
+    const height = parseInt(viewBoxParts[3], 10);
+
+    const paths = Array.from(svgElement.querySelectorAll('path'));
+    const body = paths.map(path => path.outerHTML).join(' ');
+
+    return {
+      width,
+      height,
+      body,
+    };
+  } catch (error) {
+    console.error('解析 SVG 失败:', error);
+    return svg;
+  }
+}
+