eoss 0.1.0-alpha.4 → 0.1.0-alpha.6

package/lib/utils/util.js

@@ -14,15 +14,10 @@ exports.confirm = exports.concatenate = exports.coerceTruthyValueToArray = void
 exports.debounce = debounce;
 exports.generateId = exports.formatFileSize = exports.extend = exports.exportXls = exports.exclAttribute = exports.escapeRegexpString = exports.error = exports.encode = exports.downloadFile = exports.domEval = exports.delUrlParam = exports.decode = void 0;
 exports.get = get;
-exports.getParams = exports.getObjectType = exports.getMyWinTop = exports.getLength = exports.getFileType = void 0;
-exports.getPropByPath = getPropByPath;
-exports.getZoom = exports.getWinTop = exports.getValues = exports.getValueByPath = exports.getTypeName = exports.getStyle = exports.getScript = void 0;
+exports.getZoom = exports.getWinTop = exports.getValues = exports.getValueByPath = exports.getTypeName = exports.getStyle = exports.getScript = exports.getPropByPath = exports.getParams = exports.getObjectType = exports.getMyWinTop = exports.getLength = exports.getFileType = void 0;
 exports.grouping = grouping;
 exports.guid = guid;
-exports.hasChars = void 0;
-exports.hasOwn = hasOwn;
-exports.lowerCase = exports.looseEqual = exports.loading = exports.loadJs = exports.kebabCase = exports.joinUrl = exports.isObjectEqual = exports.isIE = exports.isFunction = exports.isFirefox = exports.isExist = exports.isEqual = exports.isEmpty = exports.isEdge = exports.indexOfObj = exports.identical = void 0;
-exports.noop = noop;
+exports.noop = exports.lowerCase = exports.looseEqual = exports.loading = exports.loadJs = exports.kebabCase = exports.joinUrl = exports.isObjectEqual = exports.isIE = exports.isFunction = exports.isFirefox = exports.isExist = exports.isEqual = exports.isEmpty = exports.isEdge = exports.indexOfObj = exports.identical = exports.hasOwn = exports.hasChars = void 0;
 exports.objToArray = objToArray;
 exports.overbrim = void 0;
 exports.pager = pager;
@@ -32,9 +27,7 @@ exports.sendMessage = exports.rmbToCapital = exports.requestAnimationFrame = exp
 exports.set = set;
 exports.takeRight = exports.takeLeft = exports.sum = exports.success = exports.startWith = exports.setScale = exports.setFavicon = void 0;
 exports.throttle = throttle;
-exports.toFunction = exports.toFixed = exports.timestampUrl = void 0;
-exports.toObject = toObject;
-exports.trimWhitespace = void 0;
+exports.trimWhitespace = exports.toObject = exports.toFunction = exports.toFixed = exports.timestampUrl = void 0;
 exports.uid = uid;
 exports.winTopOpen = exports.watermark = exports.warning = exports.valueEquals = exports.uuid = exports.urlJoinParams = exports.upperType = exports.updateTheme = void 0;
 var _isArray = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/array/is-array"));
@@ -47,11 +40,11 @@ var _setTimeout2 = _interopRequireDefault(require("@babel/runtime-corejs3/core-j
 var _lastIndexOf = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/last-index-of"));
 var _includes = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/includes"));
 var _sort = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/sort"));
+var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
 var _every = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/every"));
 var _isFinite = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/number/is-finite"));
 var _reduce = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/reduce"));
 var _parseFloat2 = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/parse-float"));
-var _concat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/concat"));
 var _endsWith = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/ends-with"));
 var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/map"));
 var _url = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/url"));
@@ -68,9 +61,9 @@ var _types = require("./types");
 var _messageBox = _interopRequireDefault(require("../../packages/message-box"));
 var _date = require("./date");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-function _extends() { var _context8; return _extends = _Object$assign ? _bindInstanceProperty(_context8 = _Object$assign).call(_context8) : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
-function _createForOfIteratorHelperLoose(r, e) { var _context7; var t = "undefined" != typeof _Symbol && _getIteratorMethod(r) || r["@@iterator"]; if (t) return _bindInstanceProperty(_context7 = (t = t.call(r)).next).call(_context7, t); if (_Array$isArray2(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var o = 0; return function () { return o >= r.length ? { done: !0 } : { done: !1, value: r[o++] }; }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function _unsupportedIterableToArray(r, a) { if (r) { var _context6; if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = _sliceInstanceProperty2(_context6 = {}.toString.call(r)).call(_context6, 8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? _Array$from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _extends() { var _context0; return _extends = _Object$assign ? _bindInstanceProperty(_context0 = _Object$assign).call(_context0) : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _createForOfIteratorHelperLoose(r, e) { var _context9; var t = "undefined" != typeof _Symbol && _getIteratorMethod(r) || r["@@iterator"]; if (t) return _bindInstanceProperty(_context9 = (t = t.call(r)).next).call(_context9, t); if (_Array$isArray2(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var o = 0; return function () { return o >= r.length ? { done: !0 } : { done: !1, value: r[o++] }; }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { var _context8; if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = _sliceInstanceProperty2(_context8 = {}.toString.call(r)).call(_context8, 8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? _Array$from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
 function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function _readOnlyError(r) { throw new TypeError('"' + r + '" is read-only'); }
 var _get = require('lodash/get');
@@ -81,22 +74,57 @@ var hasOwnProperty = Object.prototype.hasOwnProperty;
 // 导入date中的formatDate函数
 
 var publicKey = 'abcdefghijklmnopqrstuvwxyz12345678';
-function noop() {}
-;
-function hasOwn(obj, key) {
+
+/**
+ * 空函数
+ * @desc 不执行任何操作的空函数
+ * @return {undefined}
+ **/
+var noop = exports.noop = function noop() {};
+
+/**
+ * 检查对象是否拥有指定属性
+ * @desc 检查对象自身是否包含指定的属性（不包括原型链上的属性）
+ * @param {Object} obj - 要检查的对象
+ * @param {string} key - 要检查的属性名
+ * @return {boolean} 是否拥有该属性
+ **/
+var hasOwn = exports.hasOwn = function hasOwn(obj, key) {
+  if (!(0, _types.isObject)(obj) && typeof obj !== 'object') {
+    return false;
+  }
   return hasOwnProperty.call(obj, key);
-}
-;
-function toObject(arr) {
+};
+
+/**
+ * 将数组转换为对象
+ * @desc 将对象数组合并为一个对象
+ * @param {Array} [arr=[]] - 对象数组
+ * @return {Object} 合并后的对象
+ **/
+var toObject = exports.toObject = function toObject(arr) {
+  if (arr === void 0) {
+    arr = [];
+  }
   var res = {};
+  if (!(0, _isArray.default)(arr)) {
+    return res;
+  }
   for (var i = 0; i < arr.length; i++) {
     if (arr[i]) {
       _extend(res, arr[i]);
     }
   }
   return res;
-}
-;
+};
+
+/**
+ * 根据路径获取对象属性值
+ * @desc 根据点分隔的路径字符串获取对象中的属性值
+ * @param {Object} object - 源对象
+ * @param {string} prop - 属性路径（如 'a.b.c'）
+ * @return {*} 获取到的属性值，如果路径不存在则返回null
+ **/
 var getValueByPath = exports.getValueByPath = function getValueByPath(object, prop) {
   if (Object.prototype.toString.call(object).toLowerCase() !== '[object object]') {
     return object;
@@ -116,7 +144,33 @@ var getValueByPath = exports.getValueByPath = function getValueByPath(object, pr
   }
   return result;
 };
-function getPropByPath(obj, path, strict) {
+
+/**
+ * 获取属性路径信息
+ * @desc 获取对象属性路径的详细信息，包括父对象、属性名和属性值
+ * @param {Object} obj - 源对象
+ * @param {string} path - 属性路径（如 'a.b.c' 或 'a[0].b'）
+ * @param {boolean} [strict=false] - 是否严格模式，严格模式下路径不存在会抛出错误
+ * @return {Object} 包含父对象(o)、属性名(k)和属性值(v)的对象
+ **/
+var getPropByPath = exports.getPropByPath = function getPropByPath(obj, path, strict) {
+  if (strict === void 0) {
+    strict = false;
+  }
+  if (!(0, _types.isObject)(obj) && typeof obj !== 'object') {
+    return {
+      o: null,
+      k: '',
+      v: null
+    };
+  }
+  if (!(0, _types.isString)(path)) {
+    return {
+      o: obj,
+      k: '',
+      v: null
+    };
+  }
   var tempObj = obj;
   path = path.replace(/\[(\w+)\]/g, '.$1');
   path = path.replace(/^\./, '');
@@ -139,11 +193,24 @@ function getPropByPath(obj, path, strict) {
     k: keyArr[i],
     v: tempObj ? tempObj[keyArr[i]] : null
   };
-}
-;
+};
+
+/**
+ * 生成随机ID
+ * @desc 生成一个1-9999之间的随机整数作为ID
+ * @return {number} 随机ID
+ **/
 var generateId = exports.generateId = function generateId() {
   return Math.floor(Math.random() * 10000);
 };
+
+/**
+ * 检查两个数组是否值相等
+ * @desc 深度比较两个数组是否包含相同的元素（严格相等比较）
+ * @param {Array} a - 第一个数组
+ * @param {Array} b - 第二个数组
+ * @return {boolean} 数组是否值相等
+ **/
 var valueEquals = exports.valueEquals = function valueEquals(a, b) {
   // see: https://stackoverflow.com/questions/3115982/how-to-check-if-two-arrays-are-equal-with-javascript
   if (a === b) return true;
@@ -155,6 +222,13 @@ var valueEquals = exports.valueEquals = function valueEquals(a, b) {
   }
   return true;
 };
+
+/**
+ * 转义正则表达式特殊字符
+ * @desc 将字符串中的正则表达式特殊字符转义，使其可以安全地用于正则表达式
+ * @param {*} [value=''] - 要转义的字符串
+ * @return {string} 转义后的字符串
+ **/
 var escapeRegexpString = exports.escapeRegexpString = function escapeRegexpString(value) {
   if (value === void 0) {
     value = '';
@@ -163,7 +237,20 @@ var escapeRegexpString = exports.escapeRegexpString = function escapeRegexpStrin
 };
 
 // TODO: use native Array.find, Array.findIndex when IE support is dropped
+/**
+ * 查找数组中符合条件的元素索引
+ * @desc 查找数组中第一个满足测试函数的元素的索引
+ * @param {Array} arr - 要查找的数组
+ * @param {Function} pred - 测试函数，返回true表示找到匹配元素
+ * @return {number} 找到的元素索引，未找到返回-1
+ **/
 var arrayFindIndex = exports.arrayFindIndex = function arrayFindIndex(arr, pred) {
+  if (!(0, _isArray.default)(arr)) {
+    return -1;
+  }
+  if (typeof pred !== 'function') {
+    return -1;
+  }
   for (var i = 0; i !== arr.length; ++i) {
     if (pred(arr[i])) {
       return i;
@@ -171,12 +258,32 @@ var arrayFindIndex = exports.arrayFindIndex = function arrayFindIndex(arr, pred)
   }
   return -1;
 };
+
+/**
+ * 查找数组中符合条件的元素
+ * @desc 查找数组中第一个满足测试函数的元素
+ * @param {Array} arr - 要查找的数组
+ * @param {Function} pred - 测试函数，返回true表示找到匹配元素
+ * @return {*} 找到的元素，未找到返回undefined
+ **/
 var arrayFind = exports.arrayFind = function arrayFind(arr, pred) {
+  if (!(0, _isArray.default)(arr)) {
+    return undefined;
+  }
+  if (typeof pred !== 'function') {
+    return undefined;
+  }
   var idx = arrayFindIndex(arr, pred);
   return idx !== -1 ? arr[idx] : undefined;
 };
 
 // coerce truthy value to array
+/**
+ * 将真值转换为数组
+ * @desc 如果输入是数组则直接返回，否则将真值包装为数组，假值返回空数组
+ * @param {*} val - 要转换的值
+ * @return {Array} 转换后的数组
+ **/
 var coerceTruthyValueToArray = exports.coerceTruthyValueToArray = function coerceTruthyValueToArray(val) {
   if ((0, _isArray.default)(val)) {
     return val;
@@ -282,7 +389,7 @@ function objToArray(obj) {
 }
 
 // requestAnimationFrame 适配函数
-var raFrame = window.requestAnimationFrame || window.webkitRequestAnimationFrame || function (callback) {
+var raFrame = window.requestAnimationFrame || window['webkitRequestAnimationFrame'] || function (callback) {
   return (0, _setTimeout2.default)(callback, 1000 / 60);
 };
 
@@ -315,7 +422,7 @@ var requestAnimationFrame = exports.requestAnimationFrame = raFrame;
  * })
  * cancelAnimationFrame(id)
  */
-var cancelAnimationFrame = exports.cancelAnimationFrame = window.cancelAnimationFrame || window.webkitRequestAnimationFrame || function (id) {
+var cancelAnimationFrame = exports.cancelAnimationFrame = window.cancelAnimationFrame || window['webkitCancelAnimationFrame'] || function (id) {
   window.clearTimeout(id);
 };
 
@@ -499,7 +606,8 @@ function pager(data, page, size) {
 /**
  * getWinTop
  * @desc 获取同域的top窗口
- * @param {object} wind - window对象
+ * @param {object} [wind] - window对象
+ * @return {Window} 同域的top窗口
  **/
 var _getWinTop = exports.getWinTop = function getWinTop(wind) {
   wind = wind ? wind : window.__WUJIE_RAW_WINDOW__ ? window.__WUJIE_RAW_WINDOW__ : window;
@@ -645,28 +753,35 @@ var getFileType = exports.getFileType = function getFileType(fileName) {
 
 /**
  * arrUnique
- * @desc:数组元素对象去重
+ * @desc 数组元素对象去重
  * @author huangbo
  * @date 2022年5月7日
- * @param {Object} [data] - 原始数组
+ * @param {Array} [data] - 原始数组
  * @param {String} [key] - 对象子元素的属性名
+ * @return {Array} 去重后的数组
  **/
 var arrUnique = exports.arrUnique = function arrUnique(data, key) {
+  // 验证输入参数
+  if (!(0, _isArray.default)(data) || data.length === 0) return [];
   var newArr = [];
   if (key === undefined) {
-    (0, _sort.default)(data).call(data);
-    newArr = [data[0]];
-    for (var i = 1; i < data.length; i++) {
-      if (data[i] !== newArr[newArr.length - 1]) {
-        newArr.push(data[i]);
+    var _context2, _context3;
+    // 对基本类型数组去重
+    var sortedData = (0, _sort.default)(_context2 = (0, _concat.default)(_context3 = []).call(_context3, data)).call(_context2); // 避免修改原数组
+    newArr = [sortedData[0]];
+    for (var i = 1; i < sortedData.length; i++) {
+      if (sortedData[i] !== newArr[newArr.length - 1]) {
+        newArr.push(sortedData[i]);
       }
     }
   } else {
+    // 对对象数组按指定键去重
     var obj = {};
     for (var _i = 0; _i < data.length; _i++) {
-      if (!obj[data[_i][key]]) {
-        newArr.push(data[_i]);
-        obj[data[_i][key]] = true;
+      var item = data[_i];
+      if (item && obj[item[key]] === undefined) {
+        newArr.push(item);
+        obj[item[key]] = true;
       }
     }
   }
@@ -685,17 +800,19 @@ var average = exports.average = function average() {
   for (var _len2 = arguments.length, numbers = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
     numbers[_key2] = arguments[_key2];
   }
-  // Ensure that all arguments are valid numbers
+  // 处理空参数情况
+  if (numbers.length === 0) return 0;
+
+  // 确保所有参数都是有效数字
   if (!(0, _every.default)(numbers).call(numbers, _isFinite.default)) {
     throw new Error('Invalid input. Please provide valid numbers.');
   }
 
-  // Calculate the average of the numbers
+  // 计算平均值
   var sum = (0, _reduce.default)(numbers).call(numbers, function (acc, num) {
     return acc + num;
   }, 0);
-  var average = sum / numbers.length;
-  return average;
+  return sum / numbers.length;
 };
 
 /**
@@ -711,7 +828,9 @@ var formatFileSize = exports.formatFileSize = function formatFileSize(size, digi
   if (digits === void 0) {
     digits = 2;
   }
-  if (size === 0) return '';
+  // 验证输入参数
+  if (size === 0 || typeof size !== 'number' || isNaN(size)) return '';
+  if (typeof digits !== 'number' || isNaN(digits)) digits = 2;
   var k = 1024;
   var sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
   var i = Math.floor(Math.log(size) / Math.log(k));
@@ -724,9 +843,10 @@ var formatFileSize = exports.formatFileSize = function formatFileSize(size, digi
 
 /**
  * browser
- * @desc:浏览器类型
+ * @desc 浏览器类型
  * @author huangbo
  * @date 2022年5月7日
+ * @return {string|undefined} 浏览器类型标识
  **/
 var browser = exports.browser = function browser() {
   var reg = {
@@ -744,9 +864,14 @@ var browser = exports.browser = function browser() {
 
 /**
  * busEmit
- * @desc:发送事件
+ * @desc 发送事件
  * @author huangbo
  * @date 2022年5月7日
+ * @param {Object} that - Vue实例或包含bus的对象
+ * @param {Object} options - 事件选项
+ * @param {string} options.method - 事件名称
+ * @param {Array|*} options.args - 事件参数
+ * @param {Object} [options.opener] - 窗口对象（用于跨窗口通信）
  **/
 var busEmit = exports.busEmit = function busEmit(that, _ref) {
   var method = _ref.method,
@@ -763,7 +888,7 @@ var busEmit = exports.busEmit = function busEmit(that, _ref) {
     return;
   }
   if (isIE()) {
-    var _context2;
+    var _context4;
     if (window.top !== window.self) {
       window.top.postMessage({
         method: method,
@@ -773,14 +898,14 @@ var busEmit = exports.busEmit = function busEmit(that, _ref) {
       return;
     }
     var bus = that ? that.bus || that.$root.Bus || that.$root.$bus : null;
-    bus && ((0, _isArray.default)(args) ? bus.$emit.apply(bus, (0, _concat.default)(_context2 = [method]).call(_context2, args)) : bus.$emit(method, args));
+    bus && ((0, _isArray.default)(args) ? bus.$emit.apply(bus, (0, _concat.default)(_context4 = [method]).call(_context4, args)) : bus.$emit(method, args));
   } else {
-    var _context4;
+    var _context6;
     if (window.top !== window.self) {
       var _bus = window.$wujie ? window.$wujie.bus : null;
       if (_bus) {
-        var _context3;
-        (0, _isArray.default)(args) ? _bus.$emit.apply(_bus, (0, _concat.default)(_context3 = [method]).call(_context3, args)) : _bus.$emit(method, args);
+        var _context5;
+        (0, _isArray.default)(args) ? _bus.$emit.apply(_bus, (0, _concat.default)(_context5 = [method]).call(_context5, args)) : _bus.$emit(method, args);
       } else {
         window.top.postMessage({
           method: method,
@@ -791,7 +916,7 @@ var busEmit = exports.busEmit = function busEmit(that, _ref) {
       return;
     }
     var _bus2 = that ? that.bus || that.$root.Bus || that.$root.$bus : null;
-    _bus2 && ((0, _isArray.default)(args) ? _bus2.$emit.apply(_bus2, (0, _concat.default)(_context4 = [method]).call(_context4, args)) : _bus2.$emit(method, args));
+    _bus2 && ((0, _isArray.default)(args) ? _bus2.$emit.apply(_bus2, (0, _concat.default)(_context6 = [method]).call(_context6, args)) : _bus2.$emit(method, args));
   }
 };
 
@@ -799,6 +924,7 @@ var busEmit = exports.busEmit = function busEmit(that, _ref) {
  * chunkToChinese
  * @desc 将四位数的整数转换为中文大写
  * @param {number} chunk - 数字
+ * @return {string} 中文大写数字
  **/
 var chunkToChinese = exports.chunkToChinese = function chunkToChinese(chunk) {
   var numberToChinese = ['零', '壹', '贰', '叁', '肆', '伍', '陆', '柒', '捌', '玖'];
@@ -823,7 +949,6 @@ var chunkToChinese = exports.chunkToChinese = function chunkToChinese(chunk) {
 
 /**
  * concatenate
- * @desc 指定连接符合并文本
  * @desc 使用指定的连接符合并文本字符串
  * @author SuTao
  * @date 2023年12月14日
@@ -845,11 +970,13 @@ var concatenate = exports.concatenate = function concatenate(separator) {
 
 /**
  * delUrlParam
- * @desc:删除url指定参数
+ * @desc 删除url指定参数
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [url] - url地址
- * @param {String,Array} [key] - 参数名
+ * @param {Object} options - 参数选项
+ * @param {String} [options.url] - url地址
+ * @param {String|Array} [options.key] - 参数名
+ * @return {string} 删除参数后的url
  **/
 var delUrlParam = exports.delUrlParam = function delUrlParam(_ref2) {
   var url = _ref2.url,
@@ -897,7 +1024,7 @@ var delUrlParam = exports.delUrlParam = function delUrlParam(_ref2) {
 
 /**
  * domEval
- * @desc:添加js内容
+ * @desc 添加js内容
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [code] - js内容
@@ -910,10 +1037,10 @@ var domEval = exports.domEval = function domEval(code) {
 
 /**
  * downloadFile
- * @desc:下载附件
+ * @desc 下载附件
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [code] - js内容
+ * @param {String} fileUrl - 文件下载地址
  **/
 var downloadFile = exports.downloadFile = function downloadFile(fileUrl) {
   var link = document.createElement('a');
@@ -927,10 +1054,11 @@ var downloadFile = exports.downloadFile = function downloadFile(fileUrl) {
 
 /**
  * encode
- * @desc:加密
+ * @desc 加密
  * @author huangbo
  * @date 2022年5月7日
- * @param {string} [data] - 被加密的字符串
+ * @param {string} value - 被加密的字符串
+ * @return {string} 加密后的字符串
  **/
 var encode = exports.encode = function encode(value) {
   var kleng = publicKey.length;
@@ -954,11 +1082,11 @@ var encode = exports.encode = function encode(value) {
 
 /**
  * decode
- * @desc:解密
+ * @desc 解密
  * @author huangbo
  * @date 2022年5月7日
- * @param {string} [value] - 被解密的加密字符串
- * @param {string} [key] - 私钥
+ * @param {string} value - 被解密的加密字符串
+ * @return {string} 解密后的字符串
  **/
 var decode = exports.decode = function decode(value) {
   var kleng = publicKey.length;
@@ -985,11 +1113,14 @@ var decode = exports.decode = function decode(value) {
 };
 
 /**
- * 排除属性
- * @desc:exclAttribute
+ * exclAttribute
+ * @desc 排除对象中的指定属性
  * @author huangbo
  * @date 2022年5月7日
- * @param {String/Array} [attrs] - 要排除的属性
+ * @param {Object} options - 参数选项
+ * @param {String|Array} [options.attrs='value'] - 要排除的属性
+ * @param {Object} options.data - 源对象
+ * @return {Object} 排除属性后的新对象
  **/
 // 用于缓存exclAttribute的结果
 var _exclAttributeCache = new _map.default();
@@ -1035,8 +1166,9 @@ var exclAttribute = exports.exclAttribute = function exclAttribute(_ref3) {
  * @desc 导出表格数据
  * @author huangbo
  * @date 2022年5月7日
- * @param {Object} [data] - 导出数据
- * @param {String} [name] - 文件名
+ * @param {Object} options - 参数选项
+ * @param {Object} options.data - 导出数据
+ * @param {String} [options.name] - 文件名
  **/
 var exportXls = exports.exportXls = function exportXls(_ref4) {
   var data = _ref4.data,
@@ -1070,6 +1202,7 @@ var exportXls = exports.exportXls = function exportXls(_ref4) {
  * @param {Boolean} [deep] - 是否深拷贝
  * @param {Object} [target] - 目标对象
  * @param {...Object} [source] - 源对象
+ * @return {Object} 拷贝后的对象
  **/
 var _extend = exports.extend = function extend() {
   // target目标对象 source源对象
@@ -1126,7 +1259,8 @@ var _extend = exports.extend = function extend() {
  * @desc 获取数据类型
  * @author huangbo
  * @date 2022年5月7日
- * @param {Any} [obj] - 任意值
+ * @param {*} [obj] - 任意值
+ * @return {string} 数据类型
  **/
 var getObjectType = exports.getObjectType = function getObjectType(obj) {
   return Object.prototype.toString.call(obj).replace(/\[object (.*)\]/, '$1').toLowerCase();
@@ -1137,10 +1271,15 @@ var getObjectType = exports.getObjectType = function getObjectType(obj) {
  * @desc 获取URL参数
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [url] - url地址
+ * @param {Object} options - 参数配置对象
+ * @param {String} [options.url] - url地址，可选
+ * @param {String} [options.name] - 参数名，可选
+ * @return {Object|string} 参数对象或指定参数值
  **/
-var getParams = exports.getParams = function getParams(key, url) {
-  var _context5;
+var getParams = exports.getParams = function getParams(_temp) {
+  var _ref5 = _temp === void 0 ? {} : _temp,
+    url = _ref5.url,
+    name = _ref5.name;
   var href = '';
   try {
     href = window.top.location.href;
@@ -1148,17 +1287,30 @@ var getParams = exports.getParams = function getParams(key, url) {
     href = window.location.href;
   }
   var paramStr = (url || href).split('?')[1] || '';
-  if (!paramStr) return '';
   var params = {};
-  (0, _forEach.default)(_context5 = paramStr.split('&')).call(_context5, function (item) {
-    var _item$split = item.split('='),
-      k = _item$split[0],
-      value = _item$split[1];
-    if (k) {
-      params[decodeURIComponent(k)] = decodeURIComponent(value || '');
-    }
-  });
-  return key ? params[key] || '' : params;
+  if (paramStr) {
+    var _context7;
+    (0, _forEach.default)(_context7 = paramStr.split('&')).call(_context7, function (item) {
+      var _item$split = item.split('='),
+        k = _item$split[0],
+        value = _item$split[1];
+      if (k) {
+        var decodedKey = decodeURIComponent(k);
+        var decodedValue = decodeURIComponent(value || '');
+
+        // 处理重复参数，保存为数组
+        if (params[decodedKey] !== undefined) {
+          if (!(0, _isArray.default)(params[decodedKey])) {
+            params[decodedKey] = [params[decodedKey]];
+          }
+          params[decodedKey].push(decodedValue);
+        } else {
+          params[decodedKey] = decodedValue;
+        }
+      }
+    });
+  }
+  return name ? params[name] || '' : params;
 };
 
 /**
@@ -1166,7 +1318,8 @@ var getParams = exports.getParams = function getParams(key, url) {
  * @desc 获取并执行JS文件
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [url] - 脚本地址
+ * @param {String} url - 脚本地址
+ * @return {Promise} Promise对象
  **/
 var getScript = exports.getScript = function getScript(url) {
   return new _promise.default(function (resolve, reject) {
@@ -1191,6 +1344,7 @@ var getScript = exports.getScript = function getScript(url) {
  * @date 2022年5月7日
  * @param {Element} [el] - dom元素
  * @param {String} [style] - 样式名称
+ * @return {string} 样式值
  **/
 var getStyle = exports.getStyle = function getStyle(el, style) {
   if (!el || !style) return '';
@@ -1215,6 +1369,7 @@ var getStyle = exports.getStyle = function getStyle(el, style) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [type] - 类型
+ * @return {string} 转换后的类型文本
  **/
 var getTypeName = exports.getTypeName = function getTypeName(type) {
   if (!type) return '';
@@ -1240,8 +1395,9 @@ var getTypeName = exports.getTypeName = function getTypeName(type) {
  * @desc 处理数据获取值
  * @author huangbo
  * @date 2022年5月7日
- * @param {Any} [obj] - 数据源
+ * @param {Object} [obj] - 数据源
  * @param {String} [key] - 键名，支持a.b.c形式
+ * @return {*} 获取的值
  **/
 var getValues = exports.getValues = function getValues(obj, key) {
   if (!obj || !key) return obj;
@@ -1259,6 +1415,7 @@ var getValues = exports.getValues = function getValues(obj, key) {
  * @desc 获取缩放比
  * @author huangbo
  * @date 2022年5月7日
+ * @return {number} 缩放比例
  **/
 var getZoom = exports.getZoom = function getZoom() {
   // 获取当前页面的缩放比例
@@ -1289,6 +1446,7 @@ var getZoom = exports.getZoom = function getZoom() {
  * @desc 获取同域top窗口
  * @author huangbo
  * @date 2022年5月7日
+ * @return {Window} 同域的top窗口
  **/
 var getMyWinTop = exports.getMyWinTop = function getMyWinTop() {
   var win = window.__WUJIE_RAW_WINDOW__ ? window.__WUJIE_RAW_WINDOW__ : window;
@@ -1312,6 +1470,7 @@ var getMyWinTop = exports.getMyWinTop = function getMyWinTop() {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [str] - 字符串
+ * @return {number} 字符个数（中文算2个，其他算1个）
  **/
 var getLength = exports.getLength = function getLength(str) {
   if (!str) return 0;
@@ -1336,6 +1495,7 @@ var getLength = exports.getLength = function getLength(str) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [url] - url地址
+ * @return {string} 更新时间戳后的url
  **/
 var timestampUrl = exports.timestampUrl = function timestampUrl(url) {
   if (!url) return '';
@@ -1357,7 +1517,8 @@ var timestampUrl = exports.timestampUrl = function timestampUrl(url) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [str] - 被检测字符串
- * @param {String} [chars] - 目标字符
+ * @param {String|Array} [chars] - 目标字符
+ * @return {boolean} 是否包含目标字符
  **/
 var hasChars = exports.hasChars = function hasChars(str, chars) {
   if (!str || !chars) return false;
@@ -1379,8 +1540,9 @@ var hasChars = exports.hasChars = function hasChars(str, chars) {
  * @desc 验证值是否相同
  * @author huangbo
  * @date 2022年5月7日
- * @param {Any} [a] - 第一个值
- * @param {Any} [b] - 第二个值
+ * @param {*} [a] - 第一个值
+ * @param {*} [b] - 第二个值
+ * @return {boolean} 值是否相同
  **/
 var _identical = exports.identical = function identical(a, b) {
   // 如果是严格相等，直接返回
@@ -1425,7 +1587,8 @@ var _identical = exports.identical = function identical(a, b) {
  * @date 2022年5月7日
  * @param {Array} [arr] - 源数组
  * @param {String} [key] - 键名
- * @param {String} [value] - 键值
+ * @param {*} [value] - 键值
+ * @return {number} 数组下标，没找到返回-1
  **/
 var indexOfObj = exports.indexOfObj = function indexOfObj(arr, key, value) {
   if (!(0, _isArray.default)(arr) || !key) return -1;
@@ -1442,7 +1605,8 @@ var indexOfObj = exports.indexOfObj = function indexOfObj(arr, key, value) {
  * @desc 判断是否为空
  * @author huangbo
  * @date 2022年5月7日
- * @param {Any} [value] - 任意值
+ * @param {*} [value] - 任意值
+ * @return {boolean} 是否为空
  **/
 var isEmpty = exports.isEmpty = function isEmpty(value) {
   if (value === undefined || value === null) {
@@ -1465,7 +1629,8 @@ var isEmpty = exports.isEmpty = function isEmpty(value) {
  * @desc 判断是否存在
  * @author huangbo
  * @date 2022年5月7日
- * @param {Any} [value] - 任意值
+ * @param {*} [value] - 任意值
+ * @return {boolean} 是否存在
  **/
 var isExist = exports.isExist = function isExist(value) {
   return value !== undefined && value !== null;
@@ -1476,7 +1641,8 @@ var isExist = exports.isExist = function isExist(value) {
  * @desc 判断是否是函数
  * @author huangbo
  * @date 2022年5月7日
- * @param {Any} [value] - 任意值
+ * @param {*} [value] - 任意值
+ * @return {boolean} 是否是函数
  **/
 var isFunction = exports.isFunction = function isFunction(value) {
   return typeof value === 'function';
@@ -1487,8 +1653,9 @@ var isFunction = exports.isFunction = function isFunction(value) {
  * @desc 判断对象是否相等
  * @author huangbo
  * @date 2022年5月7日
- * @param {Object} [a] - 第一个对象
- * @param {Object} [b] - 第二个对象
+ * @param {*} [a] - 第一个值
+ * @param {*} [b] - 第二个值
+ * @return {boolean} 对象是否相等
  **/
 var _isObjectEqual = exports.isObjectEqual = function isObjectEqual(a, b) {
   // 如果两者严格相等，直接返回true
@@ -1547,26 +1714,19 @@ var _isObjectEqual = exports.isObjectEqual = function isObjectEqual(a, b) {
   return true;
 };
 
-/**
- * joinUrl
- * @desc:判断url地址是否以字符开头，没有则添加
- * @author huangbo
- * @date 2022年5月7日
- * @param {string} [reg] - 域名或者路径
- * @param {string/array} [url] - 地址
- * @param {boolean} [single] - 是否做js沙箱隔离
- **/
 /**
  * joinUrl
  * @desc 拼接路径
  * @author huangbo
  * @date 2022年5月7日
- * @param {string} [url] - 地址
- * @param {string/array} [reg] - 域名或者路径前缀
+ * @param {Object} options - 参数选项
+ * @param {string} options.url - 地址
+ * @param {string|array} options.reg - 域名或者路径前缀
+ * @return {string} 拼接后的url
  **/
-var joinUrl = exports.joinUrl = function joinUrl(_ref5) {
-  var url = _ref5.url,
-    reg = _ref5.reg;
+var joinUrl = exports.joinUrl = function joinUrl(_ref6) {
+  var url = _ref6.url,
+    reg = _ref6.reg;
   // 类型检查
   if (typeof url !== 'string') {
     return url;
@@ -1618,7 +1778,7 @@ var joinUrl = exports.joinUrl = function joinUrl(_ref5) {
  * @desc 加载JS文件
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [url] - JS文件地址
+ * @param {String} url - JS文件地址
  * @param {Function} [callback] - 回调函数
  **/
 var loadJs = exports.loadJs = function loadJs(url, callback) {
@@ -1637,7 +1797,8 @@ var loadJs = exports.loadJs = function loadJs(url, callback) {
  * @desc 加载动画
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [text] - 提示文本
+ * @param {String} [text='请求中...'] - 提示文本
+ * @return {Object} Loading实例
  **/
 var loading = exports.loading = function loading(text) {
   if (text === void 0) {
@@ -1656,6 +1817,7 @@ var loading = exports.loading = function loading(text) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [str] - 字符串
+ * @return {string} 转换后的字符串
  **/
 var lowerCase = exports.lowerCase = function lowerCase(str) {
   if (typeof str !== 'string') return str;
@@ -1668,6 +1830,7 @@ var lowerCase = exports.lowerCase = function lowerCase(str) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {Element} [el] - dom元素
+ * @return {boolean} 是否溢出
  **/
 var overbrim = exports.overbrim = function overbrim(el) {
   if (!el) return false;
@@ -1698,6 +1861,7 @@ var overbrim = exports.overbrim = function overbrim(el) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {Object} [obj] - 源对象
+ * @return {string} URL参数字符串
  **/
 var queryParams = exports.queryParams = function queryParams(obj) {
   if (!obj || typeof obj !== 'object') return '';
@@ -1727,6 +1891,7 @@ var queryParams = exports.queryParams = function queryParams(obj) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {Function} [callback] - 回调函数
+ * @return {Function} 移除监听器的函数
  **/
 var receiveMessage = exports.receiveMessage = function receiveMessage(callback) {
   var handleMessage = function handleMessage(event) {
@@ -1748,7 +1913,8 @@ var receiveMessage = exports.receiveMessage = function receiveMessage(callback)
  * @author huangbo
  * @date 2022年5月7日
  * @param {Number} [num] - 数字
- * @param {Number} [digits] - 小数位数
+ * @param {Number} [digits=2] - 小数位数
+ * @return {string} 补全后的数字字符串
  **/
 var replenish = exports.replenish = function replenish(num, digits) {
   if (digits === void 0) {
@@ -1767,6 +1933,7 @@ var replenish = exports.replenish = function replenish(num, digits) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {Number} [num] - 金额
+ * @return {string} 人民币大写
  **/
 var rmbToCapital = exports.rmbToCapital = function rmbToCapital(num) {
   // 检查输入是否为数字
@@ -1867,12 +2034,13 @@ var setScale = exports.setScale = function setScale(scale) {
  * @desc 向iframe发送信息
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [id] - iframe元素id
- * @param {Object} [data] - 发送的数据
+ * @param {Object} options - 参数选项
+ * @param {String} options.id - iframe元素id
+ * @param {Object} options.data - 发送的数据
  **/
-var sendMessage = exports.sendMessage = function sendMessage(_ref6) {
-  var id = _ref6.id,
-    data = _ref6.data;
+var sendMessage = exports.sendMessage = function sendMessage(_ref7) {
+  var id = _ref7.id,
+    data = _ref7.data;
   var iframe = document.getElementById(id);
   if (!iframe) {
     console.error("iframe with id " + id + " not found");
@@ -1891,7 +2059,7 @@ var sendMessage = exports.sendMessage = function sendMessage(_ref6) {
  * @desc 设置浏览器图标
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [url] - 图标URL
+ * @param {String} url - 图标URL
  **/
 var setFavicon = exports.setFavicon = function setFavicon(url) {
   if (!url) {
@@ -1923,7 +2091,8 @@ var setFavicon = exports.setFavicon = function setFavicon(url) {
  * @desc 求和
  * @author huangbo
  * @date 2022年5月7日
- * @param {...number} [numbers] - 数字
+ * @param {...number} numbers - 数字
+ * @return {number} 数字的总和
  **/
 var sum = exports.sum = function sum() {
   for (var _len4 = arguments.length, numbers = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) {
@@ -1946,6 +2115,7 @@ var sum = exports.sum = function sum() {
  * @date 2022年5月7日
  * @param {String} [str] - 源字符串
  * @param {String} [searchString] - 搜索字符串
+ * @return {boolean} 是否以指定字符开头
  **/
 var startWith = exports.startWith = function startWith(str, searchString) {
   if (typeof str !== 'string' || typeof searchString !== 'string') {
@@ -1961,6 +2131,7 @@ var startWith = exports.startWith = function startWith(str, searchString) {
  * @date 2022年5月7日
  * @param {String} [str] - 源字符串
  * @param {Number} [length] - 提取长度
+ * @return {string} 提取后的字符串
  **/
 var takeLeft = exports.takeLeft = function takeLeft(str, length) {
   if (typeof str !== 'string' || typeof length !== 'number' || length < 0) {
@@ -1976,6 +2147,7 @@ var takeLeft = exports.takeLeft = function takeLeft(str, length) {
  * @date 2022年5月7日
  * @param {String} [str] - 源字符串
  * @param {Number} [length] - 提取长度
+ * @return {string} 提取后的字符串
  **/
 var takeRight = exports.takeRight = function takeRight(str, length) {
   if (typeof str !== 'string' || typeof length !== 'number' || length < 0) {
@@ -1990,6 +2162,7 @@ var takeRight = exports.takeRight = function takeRight(str, length) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [str] - 源字符串
+ * @return {string} 删除空格后的字符串
  **/
 var trimWhitespace = exports.trimWhitespace = function trimWhitespace(str) {
   if (typeof str !== 'string') {
@@ -2004,7 +2177,8 @@ var trimWhitespace = exports.trimWhitespace = function trimWhitespace(str) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {Number} [num] - 浮点数
- * @param {Number} [digits] - 小数位数
+ * @param {Number} [digits=2] - 小数位数
+ * @return {number} 保留小数位后的数字
  **/
 var toFixed = exports.toFixed = function toFixed(num, digits) {
   if (digits === void 0) {
@@ -2023,6 +2197,7 @@ var toFixed = exports.toFixed = function toFixed(num, digits) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [str] - 函数字符串
+ * @return {Function|null} 转换后的函数或null
  **/
 var toFunction = exports.toFunction = function toFunction(str) {
   if (typeof str !== 'string') {
@@ -2071,6 +2246,7 @@ var updateTheme = exports.updateTheme = function updateTheme(color) {
  * @author huangbo
  * @date 2022年5月7日
  * @param {String} [str] - 字符串
+ * @return {string} 转换后的字符串
  **/
 var upperType = exports.upperType = function upperType(str) {
   if (typeof str !== 'string') {
@@ -2084,25 +2260,47 @@ var upperType = exports.upperType = function upperType(str) {
  * @desc 对象转url拼接参数
  * @author huangbo
  * @date 2022年5月7日
- * @param {String} [url] - 源url
- * @param {Object} [params] - 参数对象
+ * @param {String} [options.url] - 源url
+ * @param {Object} [options.params] - 参数对象
+ * @param {Boolean} [options.timestamp] - 是否添加时间戳
  **/
-var urlJoinParams = exports.urlJoinParams = function urlJoinParams(url, params) {
+var urlJoinParams = exports.urlJoinParams = function urlJoinParams(_temp2) {
+  var _ref8 = _temp2 === void 0 ? {} : _temp2,
+    _ref8$url = _ref8.url,
+    url = _ref8$url === void 0 ? '' : _ref8$url,
+    _ref8$params = _ref8.params,
+    params = _ref8$params === void 0 ? {} : _ref8$params,
+    _ref8$timestamp = _ref8.timestamp,
+    timestamp = _ref8$timestamp === void 0 ? false : _ref8$timestamp;
   if (typeof url !== 'string') {
-    return url;
+    return '';
   }
-  if (!params || typeof params !== 'object') {
-    return url;
+  if (!url) {
+    return '';
+  }
+  // 处理URL中的锚点
+  var urlWithoutHash = url;
+  var hash = '';
+  var hashIndex = (0, _indexOf.default)(url).call(url, '#');
+  if (hashIndex > -1) {
+    urlWithoutHash = (0, _slice.default)(url).call(url, 0, hashIndex);
+    hash = (0, _slice.default)(url).call(url, hashIndex);
+  }
+  // 复制参数对象以避免修改原对象
+  var paramsCopy = _extends({}, params);
+  // 添加时间戳
+  if (timestamp) {
+    paramsCopy._t = (0, _now.default)();
   }
   // 将参数对象转换为URL参数字符串
-  var queryString = queryParams(params);
+  var queryString = queryParams(paramsCopy);
   if (!queryString) {
     return url;
   }
   // 检查URL是否已经包含查询参数
-  var hasQuery = (0, _includes.default)(url).call(url, '?');
+  var hasQuery = (0, _includes.default)(urlWithoutHash).call(urlWithoutHash, '?');
   // 拼接URL和查询参数
-  return "" + url + (hasQuery ? '&' : '?') + queryString;
+  return "" + urlWithoutHash + (hasQuery ? '&' : '?') + queryString + hash;
 };
 
 /**
@@ -2207,11 +2405,11 @@ var watermark = exports.watermark = function watermark(text, options) {
  * @param {String} [target] - 打开方式
  * @param {String} [name] - 窗口名称
  **/
-var winTopOpen = exports.winTopOpen = function winTopOpen(_ref7) {
-  var url = _ref7.url,
-    _ref7$target = _ref7.target,
-    target = _ref7$target === void 0 ? '_blank' : _ref7$target,
-    name = _ref7.name;
+var winTopOpen = exports.winTopOpen = function winTopOpen(_ref9) {
+  var url = _ref9.url,
+    _ref9$target = _ref9.target,
+    target = _ref9$target === void 0 ? '_blank' : _ref9$target,
+    name = _ref9.name;
   try {
     if (target === '_blank') {
       window.top.open(url, name);