@hhfenpm/utils 1.0.3 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # @hhfenpm/utils
 
-通用工具函数库，从 ma-management 和 medical-anget 两个项目中抽离的公共工具函数。
+通用工具函数库
 
 ## 安装
 
@@ -11,15 +11,9 @@ npm install @hhfenpm/utils
 ## 使用
 
 ```javascript
-// 按需导入（推荐使用驼峰命名）
-import { formatDate, validatePhone, getSession } from "@hhfenpm/utils";
-
-// 或导入整个模块
-import * as utils from "@hhfenpm/utils";
+import { formatDate, validatePhone, getSession } from "@hhfenpm/utils"
 ```
 
-**注意：** 本包导出的是驼峰命名（camelCase）的 API。如果您的项目需要向后兼容的下划线命名（如 `format_date`），请通过项目本地的 utils 层导入，这些层会提供向后兼容的别名。
-
 ## 功能模块
 
 ### 格式化 (format)
@@ -70,8 +64,7 @@ import * as utils from "@hhfenpm/utils";
 - `setSession(session, key)` - 设置 localStorage 中的 session
 - `getSession(key)` - 获取 localStorage 中的 session
 - `removeSession(key)` - 移除 localStorage 中的 session
-- `extendSession(patch, key)` - 扩展 session 中的部分属性（推荐使用）
-- `extentSession(patch, key)` - 扩展 session 中的部分属性（向后兼容，拼写错误但保留）
+- `extendSession(patch, key)` - 扩展 session 中的部分属性
 - `setSessionStorage(session, key)` - 设置 sessionStorage
 - `getSessionStorage(key)` - 获取 sessionStorage
 - `removeSessionStorage(key)` - 移除 sessionStorage
@@ -128,35 +121,17 @@ import * as utils from "@hhfenpm/utils";
   - `options.cache` - 是否支持缓存，默认false
   - `options.noWarn` - 是否禁用警告，默认false
 
-## 向后兼容说明
-
-本包导出的是标准的驼峰命名（camelCase）API。如果您需要向后兼容的下划线命名（如 `format_date`、`format_decimal` 等），请通过项目本地的 utils 层导入：
-
-```javascript
-// ✅ 推荐：通过项目 utils 层导入（提供向后兼容）
-import { format_date, format_decimal } from '@/utils/format'
-
-// ⚠️ 不推荐：直接导入 npm 包（只有驼峰命名）
-import { formatDate, formatDecimal } from '@hhfenpm/utils'
-```
-
 ## 注意事项
 
-1. **API 命名**：本包使用标准的驼峰命名（camelCase）。向后兼容的下划线命名由项目本地的 utils 层提供。
-2. **依赖要求**：需要安装 `date-fns` 作为 peerDependency。
-3. **浏览器环境**：部分函数需要在浏览器环境中使用，在 Node.js 环境中会返回默认值或警告。
-4. **拼写说明**：`extentSession` 是历史遗留的拼写错误，建议使用 `extendSession`，但 `extentSession` 仍然可用以保持向后兼容。
+- 本包使用驼峰命名（camelCase）API
+- 需要安装 `date-fns` 作为 peerDependency
+- 部分函数需要在浏览器环境中使用
 
 ## 开发
 
 ```bash
-# 安装依赖
 npm install
-
-# 构建
 npm run build
-
-# 开发模式（监听文件变化）
 npm run dev
 ```
 

package/dist/index.esm.js

@@ -2194,10 +2194,6 @@ function cleanEscapedString(input) {
   return matched[1].replace(doubleQuoteRegExp, "'");
 }
 
-/**
- * 数据格式化工具
- */
-
 /**
  * 日期格式化
  * @param {number|string} timestamp - 时间戳
@@ -2555,10 +2551,6 @@ function escapeRegExp(string) {
   return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
 }
 
-/**
- * 数据验证工具
- */
-
 /**
  * 基于Promise的表单字段验证（避免回调地狱）
  * @param {string} prop - 字段名
@@ -2615,13 +2607,9 @@ function isEmptyObj(obj) {
 function isEqual(a, b) {
   const classNameA = Object.prototype.toString.call(a);
   const classNameB = Object.prototype.toString.call(b);
-
-  // 如果数据类型不相等，则返回false
   if (classNameA !== classNameB) {
     return false
   }
-
-  // 如果数据类型相等，再根据不同数据类型分别判断
   if (classNameA === '[object Object]') {
     for (let key in a) {
       if (!isEqual(a[key], b[key])) return false
@@ -2735,13 +2723,9 @@ function isSupported() {
   }
 
   const browserInfo = getBrowserInfo();
-
-  // Firefox需要版本大于38
   if (browserInfo.type === 'Mozilla Firefox') {
     return parseFloat(browserInfo.version) > 38
   }
-
-  // 检测是否支持getUserMedia
   return !!(
     navigator.mediaDevices &&
     (navigator.mediaDevices.getUserMedia ||
@@ -2756,15 +2740,12 @@ function isSupported() {
  * @returns {Object} {isValid: boolean, message: string}
  */
 function validateMeaninglessConsecutiveSymbols(input) {
-  // 检查是否为空
   if (input.trim() === '') {
     return {
       isValid: false,
       message: '请输入内容',
     }
   }
-
-  // 检查连续符号（中英文符号）
   const symbolRegex =
     /([\-\+\=\*\.\,\;\:\!\@\#\$\%\^\&\_\(\)\[\]\{\}\|\\\/\?\<\>\~\"\'\`\s]|[\u3000-\u303F]|[\uFF00-\uFFEF])\1{6,}/;
   if (symbolRegex.test(input)) {
@@ -2773,8 +2754,6 @@ function validateMeaninglessConsecutiveSymbols(input) {
       message: '输入无意义内容，请修改',
     }
   }
-
-  // 检查连续数字
   const digitRegex = /(\d)\1{6,}/;
   if (digitRegex.test(input)) {
     return {
@@ -2782,8 +2761,6 @@ function validateMeaninglessConsecutiveSymbols(input) {
       message: '输入无意义内容，请修改',
     }
   }
-
-  // 检查连续相同文字（中英文）
   const charRegex = /([\u4e00-\u9fa5a-zA-Z])\1{2,}/;
   if (charRegex.test(input)) {
     return {
@@ -2791,17 +2768,12 @@ function validateMeaninglessConsecutiveSymbols(input) {
       message: '输入无意义内容，请修改',
     }
   }
-
   return {
     isValid: true,
     message: '',
   }
 }
 
-/**
- * 内存缓存工具
- */
-
 /**
  * 内存缓存对象
  */
@@ -2866,11 +2838,6 @@ function buildUniqueUrl(url, method, params = {}, data = {}) {
   return url
 }
 
-/**
- * Session管理工具
- * 提供localStorage和sessionStorage的封装，支持系统标识前缀
- */
-
 let systemFlag = null;
 
 /**
@@ -2967,15 +2934,6 @@ function extendSession(patch, key = 'session') {
   return getSession(key)
 }
 
-/**
- * 扩展session中的部分属性（向后兼容，拼写错误但保留）
- * @param {Object} patch - 要扩展的属性
- * @param {string} key - 键名，默认'session'
- * @returns {*} 更新后的session
- * @deprecated 请使用 extendSession，此函数保留仅为向后兼容
- */
-const extentSession = extendSession;
-
 /**
  * 设置sessionStorage
  * @param {*} session - 要存储的数据
@@ -3026,11 +2984,6 @@ function removeSessionStorage(key = 'collapse') {
   sessionStorage.removeItem(getSystemKey(key));
 }
 
-/**
- * 图片URL处理工具
- * 注意：需要配置 GLOBAL_CONFIG.backend_server
- */
-
 /**
  * 获取图片URL
  * @param {string} url - 图片路径
@@ -3038,23 +2991,17 @@ function removeSessionStorage(key = 'collapse') {
  */
 function getImgURL(url) {
   if (!url) return ''
-
-  // 如果已经是完整的URL或data URL，直接返回
   if (/^http/g.test(url) || /^data:image/g.test(url)) {
     return url
   }
-
-  // 获取基础URL
   const backendServer =
     typeof window !== 'undefined' && window.GLOBAL_CONFIG
       ? window.GLOBAL_CONFIG.backend_server
       : '';
-
   if (!backendServer) {
     console.warn('未配置 backend_server，返回原始URL');
     return url
   }
-
   return `${backendServer}/_uploads/files/${url}`
 }
 
@@ -3065,23 +3012,17 @@ function getImgURL(url) {
  */
 function getGaugeImgUrl(url) {
   if (!url) return ''
-
-  // 如果已经是完整的URL或data URL，直接返回
   if (/^http/g.test(url) || /^data:image/g.test(url)) {
     return url
   }
-
-  // 获取基础URL
   const backendServer =
     typeof window !== 'undefined' && window.GLOBAL_CONFIG
       ? window.GLOBAL_CONFIG.backend_server
       : '';
-
   if (!backendServer) {
     console.warn('未配置 backend_server，返回原始URL');
     return url
   }
-
   return `${backendServer}/api/v1/ma/mobile/resource/local/files?file=${url}`
 }
 
@@ -3095,20 +3036,12 @@ function doctorHeadImg(url, defaultUrl = './img/doc_defalut_male.jpg') {
   if (!url) {
     return defaultUrl
   }
-
-  // 如果已经是完整的URL或data URL，直接返回
   if (/^http/g.test(url) || /^data:image/g.test(url)) {
     return url
   }
-
-  // 使用OSS基础URL
   return `https://annetinfo1.oss-cn-shenzhen.aliyuncs.com/${url}`
 }
 
-/**
- * 设备检测工具函数
- */
-
 /**
  * 检测当前设备是否为平板
  * @returns {boolean} 是否为平板设备
@@ -3118,47 +3051,34 @@ function isTablet() {
     return false
   }
 
-  // 获取用户代理字符串
   const userAgent = navigator.userAgent.toLowerCase();
-
-  // 检测常见的平板设备标识
   const tabletPatterns = [
-    /ipad/, // iPad
-    /android.*tablet/, // Android 平板
-    /kindle/, // Kindle
-    /silk/, // Amazon Silk
-    /playbook/, // BlackBerry PlayBook
-    /bb10/, // BlackBerry 10
-    /rim tablet/, // BlackBerry Tablet OS
-    /windows.*touch/, // Windows 平板
-    /tablet/, // 通用平板标识
+    /ipad/,
+    /android.*tablet/,
+    /kindle/,
+    /silk/,
+    /playbook/,
+    /bb10/,
+    /rim tablet/,
+    /windows.*touch/,
+    /tablet/,
   ];
-
-  // 检查用户代理是否匹配平板模式
   const isTabletByUserAgent = tabletPatterns.some(pattern =>
     pattern.test(userAgent)
   );
-
-  // 检测屏幕尺寸和触摸支持
   const hasTouch = 'ontouchstart' in window || navigator.maxTouchPoints > 0;
   const screenWidth = window.screen.width;
   const screenHeight = window.screen.height;
   const minDimension = Math.min(screenWidth, screenHeight);
   const maxDimension = Math.max(screenWidth, screenHeight);
-
-  // 平板设备的典型屏幕尺寸范围
   const isTabletByScreenSize =
     minDimension >= 600 &&
     minDimension <= 1200 &&
     maxDimension >= 800 &&
     maxDimension <= 1600;
-
-  // 检测是否为移动设备但屏幕较大（可能是平板）
   const isMobile =
     /android|webos|iphone|ipod|blackberry|iemobile|opera mini/i.test(userAgent);
   const isLargeMobile = isMobile && minDimension >= 600;
-
-  // 综合判断：用户代理匹配 或 (屏幕尺寸符合平板特征 且 支持触摸) 或 (大屏移动设备)
   return (
     isTabletByUserAgent || (isTabletByScreenSize && hasTouch) || isLargeMobile
   )
@@ -3225,11 +3145,6 @@ function getDeviceInfo() {
   }
 }
 
-/**
- * URL参数处理工具
- * 注意：部分函数依赖浏览器环境（window.location）
- */
-
 /**
  * 将查询字符串转换为对象
  * @param {string} str - 查询字符串，如 'a=1&b=2'
@@ -3267,7 +3182,6 @@ function toQueryString(obj) {
     const encodedKey = encodeURIComponent(key);
     const values = obj[key];
     if (values && values.constructor == Array) {
-      // 数组
       const queryValues = [];
       for (let i = 0, len = values.length, value; i < len; i++) {
         value = values[i];
@@ -3275,7 +3189,6 @@ function toQueryString(obj) {
       }
       ret = ret.concat(queryValues);
     } else {
-      // 字符串
       ret.push(toQueryPair(encodedKey, values));
     }
   }
@@ -3293,10 +3206,8 @@ function urlToJson(selfUrl) {
   }
   const url = selfUrl ? selfUrl : window.location.href;
 
-  const reg = /\?.*$/; // 正则取'？后的参数'
+  const reg = /\?.*$/;
   const urlMatch = url.match(reg);
-
-  // 匹配去掉？的纯参数(正则精髓，贪婪永远匹配最后一个？后的参数)
   const param =
     urlMatch && urlMatch.length ? urlMatch[0].replace(/^\?*.*\?/, '') : '';
 
@@ -3336,16 +3247,11 @@ function setUrl(json, originUrl = '') {
     return ''
   }
   let paramJson = urlToJson().paramJson;
-  // 新的参数
   let newJson = {
     ...paramJson,
     ...json,
   };
-
-  // 参数对象 =》get参数
   let paramStr = toQueryString(newJson);
-
-  // url的origin + pathname
   let oPath = originUrl
     ? originUrl
     : window.location.origin + window.location.pathname;
@@ -3367,10 +3273,6 @@ function getUrlParams(url) {
   return urlToJson(targetUrl).paramJson
 }
 
-/**
- * 通用工具函数
- */
-
 /**
  * 将毫秒转换为时分秒
  * @param {number} ms - 毫秒数
@@ -3385,14 +3287,14 @@ function convertMilliseconds(ms, secondsTo2decimal = false) {
       seconds: 0,
     }
 
-  const hours = Math.floor(ms / 3600000); // 计算小时
-  const minutes = Math.floor((ms % 3600000) / 60000); // 计算分钟
+  const hours = Math.floor(ms / 3600000);
+  const minutes = Math.floor((ms % 3600000) / 60000);
   let seconds = 0;
 
   if (secondsTo2decimal) {
     seconds = parseFloat(((ms % 60000) / 1000).toFixed(2));
   } else {
-    seconds = Math.floor((ms % 60000) / 1000); // 计算秒数
+    seconds = Math.floor((ms % 60000) / 1000);
   }
 
   return {
@@ -3550,17 +3452,12 @@ async function copyText(text) {
   }
 
   try {
-    // 优先使用现代的Clipboard API
     if (navigator.clipboard && window.isSecureContext) {
       await navigator.clipboard.writeText(text);
       return true
     }
-
-    // 降级方案：使用传统的document.execCommand方法
     const textArea = document.createElement('textarea');
     textArea.value = text;
-
-    // 防止页面滚动
     textArea.style.position = 'fixed';
     textArea.style.left = '-999999px';
     textArea.style.top = '-999999px';
@@ -3582,10 +3479,6 @@ async function copyText(text) {
   }
 }
 
-/**
- * UUID生成工具
- */
-
 /**
  * 生成短UUID
  * @returns {string} UUID字符串
@@ -3617,11 +3510,6 @@ function uuidLong() {
   return `${uuid()}${uuid()}${uuid()}`
 }
 
-/**
- * 对象属性获取工具
- * 类似lodash的get方法，支持路径字符串和数组
- */
-
 /**
  * 将字符串路径转换为数组
  * @param {string} string - 路径字符串，如 'a.b[0].c'
@@ -3629,7 +3517,7 @@ function uuidLong() {
  */
 function stringToPath(string) {
   const result = [];
-  if (string.charCodeAt(0) === 46 /* . */) {
+  if (string.charCodeAt(0) === 46) {
     result.push('');
   }
   string.replace(
@@ -3644,7 +3532,7 @@ function stringToPath(string) {
 /**
  * 转换路径为数组格式
  * @param {string|Array} value - 路径字符串或数组
- * @param {Object} object - 对象（用于兼容性，未使用）
+ * @param {Object} object - 对象
  * @returns {Array} 路径数组
  */
 function castPath(value, object) {
@@ -3695,9 +3583,9 @@ function get(object, path, defaultValue) {
 var index = (options = {}) =>
   async config => {
     const defaultOptions = {
-      cacheTime: 0, // 缓存时间，设置为0，不清除缓存
-      cache: false, // 是否支持缓存
-      noWarn: false, // 是否有提示
+      cacheTime: 0,
+      cache: false,
+      noWarn: false,
       ...options,
     };
 
@@ -3712,7 +3600,6 @@ var index = (options = {}) =>
     if (!responsePromise || !defaultOptions.cache) {
       responsePromise = (async () => {
         try {
-          // 需要确保axios可用
           let axios = null;
           if (typeof window !== 'undefined' && window.axios) {
             axios = window.axios;
@@ -3746,7 +3633,7 @@ var index = (options = {}) =>
       }
     }
 
-    return responsePromise.then(data => JSON.parse(JSON.stringify(data))) // 为防止数据源污染
+    return responsePromise.then(data => JSON.parse(JSON.stringify(data)))
   };
 
-export { arrToLabel, arrToObj, buildUniqueUrl, cache, calculateHeight, convertMilliseconds, copyContent, copyText, copyToClip, createGuid, debounce, index as defaultAdapter, detectZoom, doctorHeadImg, escapeRegExp, extendSession, extentSession, fileDownloadHelper, findNodeOfTree, formatDate, formatDateMinute, formatDecimal, formatDecimalString, formatMoney, formatNumber, formatText, get, getBrowserInfo, getDeviceInfo, getDeviceType, getGaugeImgUrl, getHalfYearAgoToday, getImgURL, getQueryString, getSession, getSessionStorage, getSystemKey, getUrlParams, hidePhone, isEmpty, isEmptyObj, isEqual, isSupported, isTablet, isTouchDevice, mapParseReviver, mapStringifyReplacer, myDebounce, queryToObj, removeSession, removeSessionStorage, setCursor, setSession, setSessionStorage, setSystemKey, setUrl, sleep, throttle, toQueryString, urlToJson, uuid, uuidLong, validateFieldAsync, validateMeaninglessConsecutiveSymbols, validatePhone };
+export { arrToLabel, arrToObj, buildUniqueUrl, cache, calculateHeight, convertMilliseconds, copyContent, copyText, copyToClip, createGuid, debounce, index as defaultAdapter, detectZoom, doctorHeadImg, escapeRegExp, extendSession, fileDownloadHelper, findNodeOfTree, formatDate, formatDateMinute, formatDecimal, formatDecimalString, formatMoney, formatNumber, formatText, get, getBrowserInfo, getDeviceInfo, getDeviceType, getGaugeImgUrl, getHalfYearAgoToday, getImgURL, getQueryString, getSession, getSessionStorage, getSystemKey, getUrlParams, hidePhone, isEmpty, isEmptyObj, isEqual, isSupported, isTablet, isTouchDevice, mapParseReviver, mapStringifyReplacer, myDebounce, queryToObj, removeSession, removeSessionStorage, setCursor, setSession, setSessionStorage, setSystemKey, setUrl, sleep, throttle, toQueryString, urlToJson, uuid, uuidLong, validateFieldAsync, validateMeaninglessConsecutiveSymbols, validatePhone };

package/dist/index.js

@@ -2196,10 +2196,6 @@ function cleanEscapedString(input) {
   return matched[1].replace(doubleQuoteRegExp, "'");
 }
 
-/**
- * 数据格式化工具
- */
-
 /**
  * 日期格式化
  * @param {number|string} timestamp - 时间戳
@@ -2557,10 +2553,6 @@ function escapeRegExp(string) {
   return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
 }
 
-/**
- * 数据验证工具
- */
-
 /**
  * 基于Promise的表单字段验证（避免回调地狱）
  * @param {string} prop - 字段名
@@ -2617,13 +2609,9 @@ function isEmptyObj(obj) {
 function isEqual(a, b) {
   const classNameA = Object.prototype.toString.call(a);
   const classNameB = Object.prototype.toString.call(b);
-
-  // 如果数据类型不相等，则返回false
   if (classNameA !== classNameB) {
     return false
   }
-
-  // 如果数据类型相等，再根据不同数据类型分别判断
   if (classNameA === '[object Object]') {
     for (let key in a) {
       if (!isEqual(a[key], b[key])) return false
@@ -2737,13 +2725,9 @@ function isSupported() {
   }
 
   const browserInfo = getBrowserInfo();
-
-  // Firefox需要版本大于38
   if (browserInfo.type === 'Mozilla Firefox') {
     return parseFloat(browserInfo.version) > 38
   }
-
-  // 检测是否支持getUserMedia
   return !!(
     navigator.mediaDevices &&
     (navigator.mediaDevices.getUserMedia ||
@@ -2758,15 +2742,12 @@ function isSupported() {
  * @returns {Object} {isValid: boolean, message: string}
  */
 function validateMeaninglessConsecutiveSymbols(input) {
-  // 检查是否为空
   if (input.trim() === '') {
     return {
       isValid: false,
       message: '请输入内容',
     }
   }
-
-  // 检查连续符号（中英文符号）
   const symbolRegex =
     /([\-\+\=\*\.\,\;\:\!\@\#\$\%\^\&\_\(\)\[\]\{\}\|\\\/\?\<\>\~\"\'\`\s]|[\u3000-\u303F]|[\uFF00-\uFFEF])\1{6,}/;
   if (symbolRegex.test(input)) {
@@ -2775,8 +2756,6 @@ function validateMeaninglessConsecutiveSymbols(input) {
       message: '输入无意义内容，请修改',
     }
   }
-
-  // 检查连续数字
   const digitRegex = /(\d)\1{6,}/;
   if (digitRegex.test(input)) {
     return {
@@ -2784,8 +2763,6 @@ function validateMeaninglessConsecutiveSymbols(input) {
       message: '输入无意义内容，请修改',
     }
   }
-
-  // 检查连续相同文字（中英文）
   const charRegex = /([\u4e00-\u9fa5a-zA-Z])\1{2,}/;
   if (charRegex.test(input)) {
     return {
@@ -2793,17 +2770,12 @@ function validateMeaninglessConsecutiveSymbols(input) {
       message: '输入无意义内容，请修改',
     }
   }
-
   return {
     isValid: true,
     message: '',
   }
 }
 
-/**
- * 内存缓存工具
- */
-
 /**
  * 内存缓存对象
  */
@@ -2868,11 +2840,6 @@ function buildUniqueUrl(url, method, params = {}, data = {}) {
   return url
 }
 
-/**
- * Session管理工具
- * 提供localStorage和sessionStorage的封装，支持系统标识前缀
- */
-
 let systemFlag = null;
 
 /**
@@ -2969,15 +2936,6 @@ function extendSession(patch, key = 'session') {
   return getSession(key)
 }
 
-/**
- * 扩展session中的部分属性（向后兼容，拼写错误但保留）
- * @param {Object} patch - 要扩展的属性
- * @param {string} key - 键名，默认'session'
- * @returns {*} 更新后的session
- * @deprecated 请使用 extendSession，此函数保留仅为向后兼容
- */
-const extentSession = extendSession;
-
 /**
  * 设置sessionStorage
  * @param {*} session - 要存储的数据
@@ -3028,11 +2986,6 @@ function removeSessionStorage(key = 'collapse') {
   sessionStorage.removeItem(getSystemKey(key));
 }
 
-/**
- * 图片URL处理工具
- * 注意：需要配置 GLOBAL_CONFIG.backend_server
- */
-
 /**
  * 获取图片URL
  * @param {string} url - 图片路径
@@ -3040,23 +2993,17 @@ function removeSessionStorage(key = 'collapse') {
  */
 function getImgURL(url) {
   if (!url) return ''
-
-  // 如果已经是完整的URL或data URL，直接返回
   if (/^http/g.test(url) || /^data:image/g.test(url)) {
     return url
   }
-
-  // 获取基础URL
   const backendServer =
     typeof window !== 'undefined' && window.GLOBAL_CONFIG
       ? window.GLOBAL_CONFIG.backend_server
       : '';
-
   if (!backendServer) {
     console.warn('未配置 backend_server，返回原始URL');
     return url
   }
-
   return `${backendServer}/_uploads/files/${url}`
 }
 
@@ -3067,23 +3014,17 @@ function getImgURL(url) {
  */
 function getGaugeImgUrl(url) {
   if (!url) return ''
-
-  // 如果已经是完整的URL或data URL，直接返回
   if (/^http/g.test(url) || /^data:image/g.test(url)) {
     return url
   }
-
-  // 获取基础URL
   const backendServer =
     typeof window !== 'undefined' && window.GLOBAL_CONFIG
       ? window.GLOBAL_CONFIG.backend_server
       : '';
-
   if (!backendServer) {
     console.warn('未配置 backend_server，返回原始URL');
     return url
   }
-
   return `${backendServer}/api/v1/ma/mobile/resource/local/files?file=${url}`
 }
 
@@ -3097,20 +3038,12 @@ function doctorHeadImg(url, defaultUrl = './img/doc_defalut_male.jpg') {
   if (!url) {
     return defaultUrl
   }
-
-  // 如果已经是完整的URL或data URL，直接返回
   if (/^http/g.test(url) || /^data:image/g.test(url)) {
     return url
   }
-
-  // 使用OSS基础URL
   return `https://annetinfo1.oss-cn-shenzhen.aliyuncs.com/${url}`
 }
 
-/**
- * 设备检测工具函数
- */
-
 /**
  * 检测当前设备是否为平板
  * @returns {boolean} 是否为平板设备
@@ -3120,47 +3053,34 @@ function isTablet() {
     return false
   }
 
-  // 获取用户代理字符串
   const userAgent = navigator.userAgent.toLowerCase();
-
-  // 检测常见的平板设备标识
   const tabletPatterns = [
-    /ipad/, // iPad
-    /android.*tablet/, // Android 平板
-    /kindle/, // Kindle
-    /silk/, // Amazon Silk
-    /playbook/, // BlackBerry PlayBook
-    /bb10/, // BlackBerry 10
-    /rim tablet/, // BlackBerry Tablet OS
-    /windows.*touch/, // Windows 平板
-    /tablet/, // 通用平板标识
+    /ipad/,
+    /android.*tablet/,
+    /kindle/,
+    /silk/,
+    /playbook/,
+    /bb10/,
+    /rim tablet/,
+    /windows.*touch/,
+    /tablet/,
   ];
-
-  // 检查用户代理是否匹配平板模式
   const isTabletByUserAgent = tabletPatterns.some(pattern =>
     pattern.test(userAgent)
   );
-
-  // 检测屏幕尺寸和触摸支持
   const hasTouch = 'ontouchstart' in window || navigator.maxTouchPoints > 0;
   const screenWidth = window.screen.width;
   const screenHeight = window.screen.height;
   const minDimension = Math.min(screenWidth, screenHeight);
   const maxDimension = Math.max(screenWidth, screenHeight);
-
-  // 平板设备的典型屏幕尺寸范围
   const isTabletByScreenSize =
     minDimension >= 600 &&
     minDimension <= 1200 &&
     maxDimension >= 800 &&
     maxDimension <= 1600;
-
-  // 检测是否为移动设备但屏幕较大（可能是平板）
   const isMobile =
     /android|webos|iphone|ipod|blackberry|iemobile|opera mini/i.test(userAgent);
   const isLargeMobile = isMobile && minDimension >= 600;
-
-  // 综合判断：用户代理匹配 或 (屏幕尺寸符合平板特征 且 支持触摸) 或 (大屏移动设备)
   return (
     isTabletByUserAgent || (isTabletByScreenSize && hasTouch) || isLargeMobile
   )
@@ -3227,11 +3147,6 @@ function getDeviceInfo() {
   }
 }
 
-/**
- * URL参数处理工具
- * 注意：部分函数依赖浏览器环境（window.location）
- */
-
 /**
  * 将查询字符串转换为对象
  * @param {string} str - 查询字符串，如 'a=1&b=2'
@@ -3269,7 +3184,6 @@ function toQueryString(obj) {
     const encodedKey = encodeURIComponent(key);
     const values = obj[key];
     if (values && values.constructor == Array) {
-      // 数组
       const queryValues = [];
       for (let i = 0, len = values.length, value; i < len; i++) {
         value = values[i];
@@ -3277,7 +3191,6 @@ function toQueryString(obj) {
       }
       ret = ret.concat(queryValues);
     } else {
-      // 字符串
       ret.push(toQueryPair(encodedKey, values));
     }
   }
@@ -3295,10 +3208,8 @@ function urlToJson(selfUrl) {
   }
   const url = selfUrl ? selfUrl : window.location.href;
 
-  const reg = /\?.*$/; // 正则取'？后的参数'
+  const reg = /\?.*$/;
   const urlMatch = url.match(reg);
-
-  // 匹配去掉？的纯参数(正则精髓，贪婪永远匹配最后一个？后的参数)
   const param =
     urlMatch && urlMatch.length ? urlMatch[0].replace(/^\?*.*\?/, '') : '';
 
@@ -3338,16 +3249,11 @@ function setUrl(json, originUrl = '') {
     return ''
   }
   let paramJson = urlToJson().paramJson;
-  // 新的参数
   let newJson = {
     ...paramJson,
     ...json,
   };
-
-  // 参数对象 =》get参数
   let paramStr = toQueryString(newJson);
-
-  // url的origin + pathname
   let oPath = originUrl
     ? originUrl
     : window.location.origin + window.location.pathname;
@@ -3369,10 +3275,6 @@ function getUrlParams(url) {
   return urlToJson(targetUrl).paramJson
 }
 
-/**
- * 通用工具函数
- */
-
 /**
  * 将毫秒转换为时分秒
  * @param {number} ms - 毫秒数
@@ -3387,14 +3289,14 @@ function convertMilliseconds(ms, secondsTo2decimal = false) {
       seconds: 0,
     }
 
-  const hours = Math.floor(ms / 3600000); // 计算小时
-  const minutes = Math.floor((ms % 3600000) / 60000); // 计算分钟
+  const hours = Math.floor(ms / 3600000);
+  const minutes = Math.floor((ms % 3600000) / 60000);
   let seconds = 0;
 
   if (secondsTo2decimal) {
     seconds = parseFloat(((ms % 60000) / 1000).toFixed(2));
   } else {
-    seconds = Math.floor((ms % 60000) / 1000); // 计算秒数
+    seconds = Math.floor((ms % 60000) / 1000);
   }
 
   return {
@@ -3552,17 +3454,12 @@ async function copyText(text) {
   }
 
   try {
-    // 优先使用现代的Clipboard API
     if (navigator.clipboard && window.isSecureContext) {
       await navigator.clipboard.writeText(text);
       return true
     }
-
-    // 降级方案：使用传统的document.execCommand方法
     const textArea = document.createElement('textarea');
     textArea.value = text;
-
-    // 防止页面滚动
     textArea.style.position = 'fixed';
     textArea.style.left = '-999999px';
     textArea.style.top = '-999999px';
@@ -3584,10 +3481,6 @@ async function copyText(text) {
   }
 }
 
-/**
- * UUID生成工具
- */
-
 /**
  * 生成短UUID
  * @returns {string} UUID字符串
@@ -3619,11 +3512,6 @@ function uuidLong() {
   return `${uuid()}${uuid()}${uuid()}`
 }
 
-/**
- * 对象属性获取工具
- * 类似lodash的get方法，支持路径字符串和数组
- */
-
 /**
  * 将字符串路径转换为数组
  * @param {string} string - 路径字符串，如 'a.b[0].c'
@@ -3631,7 +3519,7 @@ function uuidLong() {
  */
 function stringToPath(string) {
   const result = [];
-  if (string.charCodeAt(0) === 46 /* . */) {
+  if (string.charCodeAt(0) === 46) {
     result.push('');
   }
   string.replace(
@@ -3646,7 +3534,7 @@ function stringToPath(string) {
 /**
  * 转换路径为数组格式
  * @param {string|Array} value - 路径字符串或数组
- * @param {Object} object - 对象（用于兼容性，未使用）
+ * @param {Object} object - 对象
  * @returns {Array} 路径数组
  */
 function castPath(value, object) {
@@ -3697,9 +3585,9 @@ function get(object, path, defaultValue) {
 var index = (options = {}) =>
   async config => {
     const defaultOptions = {
-      cacheTime: 0, // 缓存时间，设置为0，不清除缓存
-      cache: false, // 是否支持缓存
-      noWarn: false, // 是否有提示
+      cacheTime: 0,
+      cache: false,
+      noWarn: false,
       ...options,
     };
 
@@ -3714,7 +3602,6 @@ var index = (options = {}) =>
     if (!responsePromise || !defaultOptions.cache) {
       responsePromise = (async () => {
         try {
-          // 需要确保axios可用
           let axios = null;
           if (typeof window !== 'undefined' && window.axios) {
             axios = window.axios;
@@ -3748,7 +3635,7 @@ var index = (options = {}) =>
       }
     }
 
-    return responsePromise.then(data => JSON.parse(JSON.stringify(data))) // 为防止数据源污染
+    return responsePromise.then(data => JSON.parse(JSON.stringify(data)))
   };
 
 exports.arrToLabel = arrToLabel;
@@ -3767,7 +3654,6 @@ exports.detectZoom = detectZoom;
 exports.doctorHeadImg = doctorHeadImg;
 exports.escapeRegExp = escapeRegExp;
 exports.extendSession = extendSession;
-exports.extentSession = extentSession;
 exports.fileDownloadHelper = fileDownloadHelper;
 exports.findNodeOfTree = findNodeOfTree;
 exports.formatDate = formatDate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hhfenpm/utils",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "通用工具函数库，包含格式化、验证、缓存、Session管理、图片URL处理、设备检测、URL处理、UUID生成等常用工具",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",