mm_expand 2.3.7 → 2.3.9

package/lib/array.js

@@ -50,7 +50,7 @@ function toList(list, sub = 'sub', result = []) {
 /**
  * 排序
  * @param {string} key 属性键
- * @returns {Function(Object, Object)} 排序函数
+ * @returns {Function} 排序函数
  */
 function newSort(key) {
   var field = key;
@@ -154,8 +154,7 @@ function createDescCnSort(field) {
 
 /**
  * 列表转树形列表
- * @param {string | object} idOrConfig 主键字段名或配置对象
- * @param {string} id_or_config 主键字段名
+ * @param {string|object} id_or_config 主键字段名或配置对象
  * @param {number} value 根节点值
  * @param {string} father_id 父节点字段名
  * @param {string} sub 子节点字段名
@@ -209,7 +208,7 @@ Array.prototype.copy = function (has) {
 };
 /**
  * 遍历数组执行函数
- * @param {Function(Object):Boolean} func 处理函数
+ * @param {Function} func 处理函数
  */
 Array.prototype.func = function (func) {
   var count = this.length;
@@ -221,8 +220,7 @@ Array.prototype.func = function (func) {
 };
 /**
  * 数组转字符串
- * @param {string} splitStr 分隔符
- * @param split_str
+ * @param {string} split_str 分隔符
  * @param {string} key 对象属性名
  * @returns {string} 字符串
  */
@@ -312,8 +310,7 @@ Array.prototype._sortByValue = function (method) {
 /**
  * 获取属性排序函数
  * @param {string} method 排序方式
- * @param {boolean} isStr 是否为字符串
- * @param is_str
+ * @param {boolean} is_str 是否为字符串
  * @param {object} cs 排序对象
  * @returns {Function} 排序函数
  */
@@ -330,8 +327,7 @@ Array.prototype._getSortFunc = function (method, is_str, cs) {
 /**
  * 获取值排序函数
  * @param {string} method 排序方式
- * @param {boolean} isStr 是否为字符串
- * @param is_str
+ * @param {boolean} is_str 是否为字符串
  * @returns {Function} 排序函数
  */
 Array.prototype._getValueSortFunc = function (method, is_str) {
@@ -434,11 +430,6 @@ Array.prototype.get = function (query, single) {
     return results;
   }
 };
-/**
- *
- * query:  (object)
- *  (object)
- */
 
 /**
  * 从数组获取对象
@@ -777,9 +768,9 @@ Array.prototype.setObj = function (replacement, query, end) {
 /**
  * 设置数组中对象的属性值
  * @param {Array} items 对象列表
- * @param {object} key 对象主键
+ * @param {string} key 对象主键
  * @param {boolean} end 是否中断循环,中断只修改第一个符合条件的对象
- * @returns {Array} 对象数组
+ * @throws {Error} 第2个参数是必须的
  */
 Array.prototype.setList = function (items, key, end) {
   if (!key) {
@@ -994,7 +985,8 @@ Array.prototype.toObj = function (key) {
 
 /**
  * 将一维数组转成二维
- * @param {object} size
+ * @param {number} size 每个子数组的大小
+ * @returns {object} 返回转换后的二维对象数组
  */
 Array.prototype.to2D = function (size) {
   var arr = this;
@@ -1008,6 +1000,7 @@ Array.prototype.to2D = function (size) {
 
 /**
  * 将二维数组合并转成一维
+ * @returns {object} 返回合并后的数组对象
  */
 Array.prototype.to1D = function () {
   var source = this;

package/lib/base.js

@@ -175,6 +175,7 @@ Base.prototype._destroyCore = async function () {
 
 /**
  * 销毁模块 - 内部方法
+ * @returns {object} 返回当前对象
  * @private
  */
 Base.prototype._destroy = async function () {
@@ -183,6 +184,7 @@ Base.prototype._destroy = async function () {
 
 /**
  * 销毁
+ * @returns {object} 返回当前对象
  */
 Base.prototype.destroy = async function () {
   return await this._destroy();
@@ -383,7 +385,6 @@ Base.prototype.doEasy = async function (method, ...params) {
  * 智能执行方法（自动选择do或doEasy）
  * @param {string} method 方法名称
  * @param {...object} params 参数列表
- * @param {object} options 执行选项
  * @returns {object} 返回执行结果
  */
 Base.prototype.doSmart = async function (method, ...params) {
@@ -435,6 +436,7 @@ Base.prototype._main = async function (...params) {
 /**
  * 主要执行方法
  * @param  {...any} params 参数列表
+ * @returns {object} 返回执行结果
  */
 Base.prototype.main = async function (...params) {
   return await this._main(...params);

package/lib/date.js

@@ -3,10 +3,10 @@
  * @param {string} format 指定格式
  * @returns {string} 时间格式字符串
  */
-Date.prototype.toStr = function (fm) {
-  var format = fm;
+Date.prototype.toStr = function (format) {
+  var f = format;
   var t = this;
-  if (format.endsWith('Z')) {
+  if (f.endsWith('Z')) {
     t = t.addSeconds(-28800);
   }
   var obj = {
@@ -18,18 +18,18 @@ Date.prototype.toStr = function (fm) {
     'q+': Math.floor((t.getMonth() + 3) / 3),
     'S': t.getMilliseconds()
   };
-  var yearMatch = format.match(/(y+)/);
-  if (yearMatch) {
-    format = format.replace(yearMatch[1], (t.getFullYear() + '').substring(4 - yearMatch[1].length));
+  var year_match = f.match(/(y+)/);
+  if (year_match) {
+    f = f.replace(year_match[1], (t.getFullYear() + '').substring(4 - year_match[1].length));
   }
   for (var k in obj) {
-    var match = format.match(new RegExp('(' + k + ')'));
+    var match = f.match(new RegExp('(' + k + ')'));
     if (match) {
-      format = format.replace(match[1], match[1].length == 1 ? obj[k] : ('00' + obj[k]).substring(('' +
-  obj[k]).length));
+      f = f.replace(match[1], match[1].length == 1 ? obj[k] : ('00' + obj[k]).substring(('' +
+        obj[k]).length));
     }
   }
-  return format;
+  return f;
 };
 
 /**

package/lib/event.js

@@ -105,7 +105,7 @@ class Event {
   /**
    * 添加事件监听器
    * @param {string} event_name 事件名称
-   * @param {function} listener 监听器函数
+   * @param {Function} listener 监听器函数
    * @returns {Event} 返回this，支持链式调用
    */
   on(event_name, listener) {
@@ -142,7 +142,7 @@ class Event {
   /**
    * 添加一次性事件监听器
    * @param {string} event_name 事件名称
-   * @param {function} listener 监听器函数
+   * @param {Function} listener 监听器函数
    * @returns {Event} 返回this，支持链式调用
    */
   once(event_name, listener) {
@@ -158,7 +158,7 @@ class Event {
   /**
    * 移除事件监听器（removeListener 别名）
    * @param {string} event_name 事件名称
-   * @param {function} listener 监听器函数
+   * @param {Function} listener 监听器函数
    * @returns {Event} 返回this，支持链式调用
    */
   removeListener(event_name, listener) {
@@ -168,7 +168,7 @@ class Event {
   /**
    * 移除事件监听器
    * @param {string} event_name 事件名称
-   * @param {function} listener 监听器函数
+   * @param {Function} listener 监听器函数
    * @returns {Event} 返回this，支持链式调用
    */
   off(event_name, listener) {
@@ -456,7 +456,7 @@ class Event {
   /**
    * 前置添加事件监听器
    * @param {string} event_name 事件名称
-   * @param {function} listener 监听器函数
+   * @param {Function} listener 监听器函数
    * @returns {Event} 返回this，支持链式调用
    */
   prependListener(event_name, listener) {
@@ -494,7 +494,7 @@ class Event {
   /**
    * 前置添加一次性事件监听器
    * @param {string} event_name 事件名称
-   * @param {function} listener 监听器函数
+   * @param {Function} listener 监听器函数
    * @returns {Event} 返回this，支持链式调用
    */
   prependOnceListener(event_name, listener) {

package/lib/eventer.js

@@ -13,7 +13,7 @@ class Eventer {
     error: null, // 全局错误处理函数
     pause_enabled: true, // 是否启用暂停功能
   };
-  
+
   // 日志对象
   #logger = $.log || console;
 
@@ -53,7 +53,7 @@ class Eventer {
   setLogger(logger) {
     this.#logger = logger;
   }
-  
+
   /**
    * 获取日志记录器
    * @returns {object} 日志记录器对象
@@ -97,12 +97,8 @@ Eventer.prototype.init = async function (...args) {
  * 监听事件（支持命名空间和优先级）
  * @param {string} key 事件关键字，支持space:key格式
  * @param {object} func 触发函数
- * @param {string} name 增加名称，方便删除，当出现相同名称时会被覆盖
- * @param {number} times 执行次数 -1为无限次执行
- * @param {number} priority 优先级，数字越小优先级越高，默认为0
- * @param {object} options 其他选项，如throttle、debounce、timeout等
- * @param {string} ns 可选的显式命名空间，优先级高于key中的命名空间
- * @returns {object} 返回事件信息对象 {space, index, name, remove}，remove为移除该事件的函数
+ * @throws {Error} 事件关键字必须是非空字符串
+ * @throws {Error} 事件处理函数必须是一个函数
  */
 Eventer.prototype._validateOnParams = function (key, func) {
   if (!key || typeof key !== 'string') {
@@ -191,9 +187,6 @@ Eventer.prototype._createHandlerResult = function (space, index, name, full_key)
     space,
     index,
     name,
-    /**
-     *
-     */
     remove: () => this.off(full_key, name)
   };
 };
@@ -342,9 +335,7 @@ Eventer.prototype.once = function (key, func, name, options) {
 /**
  * 统一的事件执行引擎
  * @param {string} key 事件关键字，支持space:key格式
- * @param {object} options 执行选项
- * @param  {...any} params 传递参数
- * @returns {Promise<object>} 返回包含results和cancel方法的对象
+ * @throws {Error} 事件关键字必须是非空字符串
  * @private
  */
 Eventer.prototype._validateExec = function (key) {
@@ -370,9 +361,6 @@ Eventer.prototype._createCtx = function (key, params) {
     executed: 0,
     error_count: 0,
     cancelled: false,
-    /**
-     *
-     */
     cancel: () => {
       ctx.cancelled = true;
       this._cancelTasks(full_key);
@@ -525,9 +513,6 @@ Eventer.prototype._buildSafeResult = function (ctx) {
     return {
       results: [],
       cancelled: true,
-      /**
-       *
-       */
       cancel: () => { },
       error: return_error
     };
@@ -575,7 +560,7 @@ Eventer.prototype._createPausedResult = function () {
 
 /**
  * 执行事件列表
- * @param {object} config 配置对象
+ * @param {object} config 配置参数
  * @param {Array} config.list 事件列表
  * @param {Array} config.params 参数
  * @param {object} config.ctx 上下文
@@ -585,6 +570,8 @@ Eventer.prototype._createPausedResult = function () {
  * @param {string} config.space 命名空间
  * @param {string} config.event_key 事件键
  * @param {number} config.start_time 开始时间
+ * @param {string} config.strategy 执行策略，默认sequential
+ * @returns {object} 返回执行结果
  * @private
  */
 Eventer.prototype._executeEventList = async function (config) {
@@ -611,7 +598,7 @@ Eventer.prototype._executeEventList = async function (config) {
 
 /**
  * 顺序执行事件处理函数
- * @param config
+ * @param {object} config 配置参数
  * @private
  */
 Eventer.prototype._executeSequential = async function (config) {
@@ -650,9 +637,6 @@ Eventer.prototype._createTask = function (o, full_key) {
   let cancelled = false;
   const task = {
     id: task_id,
-    /**
-     *
-     */
     cancel: () => { cancelled = true; }
   };
 
@@ -707,7 +691,7 @@ Eventer.prototype._handleTaskError = function (e, o, ctx, task) {
 
 /**
  * 并行执行事件处理函数
- * @param config
+ * @param {object} config 配置参数
  * @private
  */
 Eventer.prototype._executeParallel = async function (config) {
@@ -738,7 +722,7 @@ Eventer.prototype._executeBatches = async function (config) {
   for (let i = 0; i < list.length && !ctx.cancelled; i += concurrency) {
     let batch = list.slice(i, i + concurrency);
     let batch_promises = batch.map((obj, batch_idx) => {
-      let global = i + batch_idx; // eslint-disable-line mm_eslint/variable-name
+      let global = i + batch_idx;
       return this._executeSingleTask({
         obj, params, ctx, full_key, arr, idx: global, proc_results
       });
@@ -764,7 +748,7 @@ Eventer.prototype._setResults = function (ctx, proc_results) {
 
 /**
  * 瀑布流执行事件处理函数
- * @param config
+ * @param {object} config 配置参数
  * @private
  */
 Eventer.prototype._executeWaterfall = async function (config) {
@@ -792,9 +776,6 @@ Eventer.prototype._createWaterfallTask = function (obj, full_key) {
   let cancelled = false;
   const task = {
     id: task_id,
-    /**
-     *
-     */
     cancel: () => { cancelled = true; }
   };
 
@@ -864,6 +845,11 @@ Eventer.prototype._callErrorHandler = function (e, obj, ctx) {
 /**
  * 竞争执行模式 - 返回第一个完成的结果
  * @param {object} config 配置参数
+ * @param {Array} config.list 事件列表
+ * @param {Array} config.params 参数
+ * @param {object} config.ctx 上下文
+ * @param {string} config.strategy 执行策略
+ * @returns {Promise<object>} 返回包含results和cancel方法的对象
  * @private
  */
 Eventer.prototype._executeRace = async function (config) {
@@ -910,9 +896,6 @@ Eventer.prototype._createRaceTask = function (obj, full_key) {
   let cancelled = false;
   const task = {
     id: task_id,
-    /**
-     *
-     */
     cancel: () => { cancelled = true; }
   };
 
@@ -960,7 +943,7 @@ Eventer.prototype._runRace = async function (promises) {
 
 /**
  * 执行单个任务（并行执行时使用）
- * @param config
+ * @param {object} config 配置参数
  * @private
  */
 Eventer.prototype._executeSingleTask = async function (config) {
@@ -983,9 +966,6 @@ Eventer.prototype._createParallelTask = function (obj, full_key) {
   let cancelled = false;
   const task = {
     id: task_id,
-    /**
-     *
-     */
     cancel: () => { cancelled = true; }
   };
 
@@ -1060,9 +1040,6 @@ Eventer.prototype.emit = function (key, ...params) {
     result.catch(e => this.log('error', '事件异步执行失败:', e));
     return {
       ...result,
-      /**
-       *
-       */
       cancel: () => {
         try {
           return result.then(r => r && typeof r.cancel === 'function' && r.cancel());
@@ -1078,9 +1055,6 @@ Eventer.prototype.emit = function (key, ...params) {
     return {
       results: [],
       cancelled: false,
-      /**
-       *
-       */
       cancel: () => { },
       error: error
     };
@@ -1386,7 +1360,6 @@ Eventer.prototype._removeSingleEvent = function (events, index_or_name) {
  * 删除整个事件
  * @private
  * @param {string} space 命名空间
- * @param {string} key 事件关键字
  * @param {string} event_key 事件键
  * @param {string} full_key 完整事件关键字
  * @returns {boolean} 删除成功返回true
@@ -1951,7 +1924,6 @@ Eventer.prototype._handleChainError = function (e, obj, ctx, results) {
  * 并行执行事件（提高性能）
  * @param {string} key 事件关键字，支持space:key格式
  * @param {object} params 传递参数
- * @param {object} options 执行选项，如concurrency（并发数限制）
  * @returns {Promise<object>} 返回包含results和cancel方法的对象
  */
 Eventer.prototype.runParallel = async function (key, ...params) {
@@ -1970,7 +1942,6 @@ Eventer.prototype.runParallel = async function (key, ...params) {
  * 并行触发事件
  * @param {string} key 事件关键字，支持space:key格式
  * @param {object} params 传递参数
- * @param {object} options 执行选项，如concurrency（并发数限制）
  * @returns {Promise<object>} 返回包含results和cancel方法的对象
  */
 Eventer.prototype.emitParallel = function (key, ...params) {
@@ -1982,23 +1953,20 @@ Eventer.prototype.emitParallel = function (key, ...params) {
   result.catch(e => this.log('error', '事件并行执行失败:', e));
   return {
     ...result,
-    /**
-     *
-     */
     cancel: () => result.then(r => r && typeof r.cancel === 'function' && r.cancel())
   };
 };
 
 /**
  * 防止内存泄漏警告
- * @param {number} max_listeners 最大监听器数量
+ * @param {number} max_listen 最大监听器数量
  * @returns {Eventer} 返回当前实例，支持链式调用
  */
-Eventer.prototype.setMaxListeners = function (max_list) {
-  if (typeof max_listeners !== 'number' || max_listeners < 0) {
+Eventer.prototype.setMaxListeners = function (max_listen) {
+  if (typeof max_listen !== 'number' || max_listen < 0) {
     throw new Error('最大监听器数量必须是一个非负数');
   }
-  this._max_listeners = max_listeners;
+  this._max_listeners = max_listen;
   return this;
 };
 
@@ -2159,7 +2127,7 @@ Eventer.prototype._createChainCtx = function (key, current_event, params) {
     error_count: 0,
     cancelled: false,
     /**
-     *
+     * 取消事件执行
      */
     cancel: () => { this.cancelled = true; }
   };
@@ -2391,7 +2359,7 @@ Eventer.prototype.getPausedStatus = function () {
   return {
     global_paused: this._paused_global,
     paused_events: Array.from(this._paused),
-    paused_spaces: Array.from(this._paused_space), // eslint-disable-line mm_eslint/variable-name
+    paused_spaces: Array.from(this._paused_space)
   };
 };
 

package/lib/file.js

@@ -136,7 +136,7 @@ function fullname(file, dir) {
 class File extends Base {
   /**
    * 构造函数，用于初始化文件类
-   * @param config
+   * @param {object} config 文件配置对象
    */
   constructor(config) {
     super(config);
@@ -486,8 +486,8 @@ function getFile(list, dir, keyword) {
  */
 class Dir extends Base {
   /**
-   *
-   * @param config
+   * 构造函数
+   * @param {object} config 目录配置对象
    */
   constructor(config) {
     super(config);
@@ -552,7 +552,6 @@ Dir.prototype.copy = function (source, target, func) {
  * 删除目录
  * @param {string} dir 目录路径
  * @param {Function} func 回调函数
- * @returns {boolean} 保存成功返回true，否则返回false
  */
 Dir.prototype.del = function (dir, func) {
   rimrafSync(dir.fullname(), func);
@@ -570,7 +569,7 @@ Dir.prototype.exists = function (dir) {
 /** === 文件类函数 === */
 /**
  * 补全路径
- * @param {string} dir
+ * @param {string} dir 文件路径
  * @returns {string} 全路径
  */
 String.prototype.fullname = function (dir) {
@@ -607,7 +606,7 @@ String.prototype.copyFile = function (file) {
 /**
  * 复制目录
  * @param {string} file 保存路径
- * @param func
+ * @param {Function} func 回调函数
  * @returns {boolean} 复制成功返回true, 失败返回false
  */
 String.prototype.copyDir = function (file, func) {
@@ -794,9 +793,8 @@ String.prototype.delDir = function (dir, func) {
 };
 
 /**
- * @创建路径
- * @param {string} dir 文件路径
- * @param dirbase
+ * 创建路径
+ * @param {string} dirbase 目录基础路径
  */
 String.prototype.addDir = function (dirbase) {
   var d = (this + '').fullname(dirbase);

package/lib/global.js

@@ -10,8 +10,7 @@ Set.prototype.del = Set.prototype.delete;
 
 /**
  * 延迟执行（休眠）
- * @param {number} milliSeconds 毫秒
- * @param milli_seconds
+ * @param {number} milli_seconds 毫秒
  * @param {object} obj 判断对象或函数
  * @param {string} key 判断的对象属性, 为存在的情况下提成退出循环
  * @example var obj = {ok: false}; sleep(2000, obj, 'ok');
@@ -21,20 +20,19 @@ function sleep(milli_seconds, obj, key) {
   var end_time = new Date().getTime() + milli_seconds;
 
   if (!obj) {
-    return simpleSleep(end_time);
+    simpleSleep(end_time);
   }
 
   if (key) {
-    return sleepWithKey(end_time, obj, key);
+    sleepWithKey(end_time, obj, key);
   } else {
-    return sleepWithFunc(end_time, obj);
+    sleepWithFunc(end_time, obj);
   }
 }
 
 /**
  * 简单休眠
- * @param {number} endTime 结束时间
- * @param end_time
+ * @param {number} end_time 结束时间
  */
 function simpleSleep(end_time) {
   while (new Date().getTime() < end_time) {
@@ -44,8 +42,7 @@ function simpleSleep(end_time) {
 
 /**
  * 带键值检查的休眠
- * @param {number} endTime 结束时间
- * @param end_time
+ * @param {number} end_time 结束时间
  * @param {object} obj 判断对象
  * @param {string} key 判断的对象属性
  */
@@ -59,8 +56,7 @@ function sleepWithKey(end_time, obj, key) {
 
 /**
  * 带函数检查的休眠
- * @param {number} endTime 结束时间
- * @param end_time
+ * @param {number} end_time 结束时间
  * @param {Function} func 判断函数
  */
 function sleepWithFunc(end_time, func) {
@@ -73,13 +69,14 @@ function sleepWithFunc(end_time, func) {
 
 /**
  * 测试函数执行速度
- * @param {Function()} func 测试的函数
- * @param {number} times = [value] 测试次数
+ * @param {Function} func 测试的函数
+ * @param {number} times = [value] 测试次数，默认值为 10000000
+ * @returns {number} 返回耗时（毫秒）
  */
-function speed(func, _times) {
-  var times = _times || 1000000;
+function speed(func, times) {
+  var t = times || 1000000;
   var t1 = (new Date()).valueOf();
-  for (var i = 0; i < times; i++) {
+  for (var i = 0; i < t; i++) {
     func();
   }
   var t2 = (new Date()).valueOf();
@@ -164,6 +161,7 @@ if (!global.$) {
   /**
    * 加载模块
    * @param {string} file 文件路径
+   * @returns {object} 加载后的模块对象
    */
   $.load = function (file) {
     return require(file);
@@ -172,6 +170,7 @@ if (!global.$) {
   /**
    * 卸载模块
    * @param {string} file 文件路径
+   * @returns {string} 卸载后的模块路径字符串
    */
   $.unload = function (file) {
     var f = require.resolve(file);
@@ -182,6 +181,7 @@ if (!global.$) {
   /**
    * 重载模块
    * @param {string} file 文件路径
+   * @returns {object} 重载后的模块对象
    */
   $.reload = function (file) {
     var f = $.unload(file);

package/lib/lang.js

@@ -307,10 +307,10 @@ Lang.prototype.tc = function (key, count, ...param) {
 /**
  * 格式化日期
  * @param {Date | number} dt - 日期对象或时间戳
- * @param {string} [format='YYYY-MM-DD'] - 格式
+ * @param {string} format - 格式，例如 'YYYY-MM-DD hh:mm:ss'
  * @returns {string} 格式化后的日期字符串
  */
-Lang.prototype.formatDate = function (dt, _format) {
+Lang.prototype.formatDate = function (dt, format = 'YYYY-MM-DD hh:mm:ss') {
   // 参数校验
   if (!dt) {
     throw new TypeError('date不能为空');
@@ -321,7 +321,6 @@ Lang.prototype.formatDate = function (dt, _format) {
     throw new TypeError('无效的日期');
   }
 
-  var format = _format || 'YYYY-MM-DD';
   var year = d.getFullYear();
   var month = String(d.getMonth() + 1).padStart(2, '0');
   var day = String(d.getDate()).padStart(2, '0');
@@ -331,8 +330,10 @@ Lang.prototype.formatDate = function (dt, _format) {
 
   return format
     .replace('YYYY', year)
+    .replace('yyyy', year)
     .replace('MM', month)
     .replace('DD', day)
+    .replace('dd', day)
     .replace('HH', hours)
     .replace('hh', hours)
     .replace('mm', minutes)
@@ -342,19 +343,19 @@ Lang.prototype.formatDate = function (dt, _format) {
 /**
  * 格式化数字为字符串
  * @param {number} num - 要格式化的数字
- * @param {object} [opt] - 选项
- * @param {number} [opt.decimals=2] - 小数位数
- * @param {string} [opt.decimalSeparator] - 小数分隔符
- * @param {string} [opt.thousandsSeparator] - 千位分隔符
+ * @param {object} [options] - 选项
+ * @param {number} [options.decimals=2] - 小数位数
+ * @param {string} [options.decimalSeparator] - 小数分隔符
+ * @param {string} [options.thousandsSeparator] - 千位分隔符
  * @returns {string} 格式化后的数字字符串
  */
-Lang.prototype.formatNumber = function (num, _opt) {
+Lang.prototype.formatNumber = function (num, options = {}) {
   // 参数校验
   if (typeof num !== 'number' || isNaN(num)) {
     throw new TypeError('num必须是有效的数字');
   }
 
-  var opt = _opt || {};
+  var opt = options || {};
   var decimals = typeof opt.decimals === 'number' ? opt.decimals : 2;
 
   // 获取语言特定的分隔符

package/lib/object.js

@@ -212,7 +212,7 @@ function processObject(source_obj, target_obj, exact, depth) {
  * @param {boolean} supplement 是否补充没有的对象
  * @returns {object} 修改后的目标对象
  */
-function push(target, source, supplement) {
+function push(target, source, supplement = false) {
   if (!target || !source || typeof target !== 'object' || typeof source !== 'object') {
     return target;
   }
@@ -452,11 +452,11 @@ function saveJson(source, target, format = true) {
  * @param {boolean} options.cdata 是否使用CDATA
  * @returns {string} XML字符串
  */
-function saveXml(source, target, _options = {}) {
+function saveXml(source, target, options = {}) {
   // 设置默认选项
-  var options = _options;
-  if (typeof options !== 'object' || options === null) {
-    options = {};
+  var ops = options;
+  if (typeof ops !== 'object' || ops === null) {
+    ops = {};
   }
 
   // 默认启用格式化
@@ -464,7 +464,7 @@ function saveXml(source, target, _options = {}) {
     options.format = true;
   }
 
-  var xml_str = toXml(source, options.format, options.attributes, options.cdata);
+  var xml_str = toXml(source, ops.format, ops.attributes, ops.cdata);
   if (typeof target === 'string') {
     require('fs').writeFileSync(target, xml_str);
   } else if (typeof target === 'object' && target.write) {
@@ -472,6 +472,7 @@ function saveXml(source, target, _options = {}) {
   }
   return xml_str;
 };
+
 /**
  * 复制对象或值
  * @param {any} source 源对象或值
@@ -852,7 +853,7 @@ function _setDiffTypeProp(result, key, values) {
 /**
  * 将数组转换为对象
  * @param {Array} source 源数组
- * @param key
+ * @param {string} key 键属性名，默认值为 'key'
  * @returns {object} 转换后的对象
  */
 function arrToObj(source, key = 'key') {

package/lib/ret.js

@@ -85,7 +85,7 @@ Ret.prototype._getMessage = function (code) {
  * @param {boolean} diy 是否自定义错误提示
  * @returns {object} JSON-RPC 2.0响应格式
  */
-Ret.prototype._toJsonRPC = function (result, error, id, _diy = true) {
+Ret.prototype._toJsonRPC = function (result, error, id, diy = true) {
   const ret = {
   };
   if (id) {
@@ -99,8 +99,7 @@ Ret.prototype._toJsonRPC = function (result, error, id, _diy = true) {
     if (!error.code) {
       error.code = this.config.error_code;
     }
-    var diy = _diy || this.config.message_diy;
-    if (!diy) {
+    if (!(diy || this.config.message_diy)) {
       error.message = this._getMessage(error.code) || error.message;
     }
     else if (!error.message) {
@@ -128,9 +127,9 @@ Ret.prototype._toJsonRPC = function (result, error, id, _diy = true) {
  * @param {object.message} error.message 返回的错误提示
  * @param {string} id 消息ID
  * @param {boolean} diy 是否自定义错误提示
- * @returns {object} RESTful响应格式
+ * @returns {object} RESTful响应格式对象
  */
-Ret.prototype._toRESTful = function (result, error, id, _diy = true) {
+Ret.prototype._toRESTful = function (result, error, id, diy = true) {
   let ret = {};
   if (id) {
     ret.id = id;
@@ -143,8 +142,7 @@ Ret.prototype._toRESTful = function (result, error, id, _diy = true) {
   }
   else if (error) {
     code = error.code || this.config.error_code;
-    var diy = _diy || this.config.message_diy;
-    if (!diy) {
+    if (!(diy || this.config.message_diy)) {
       msg = this._getMessage(code) || error.message || error.msg;
     }
     else if (!error.message && !error.msg) {
@@ -236,13 +234,12 @@ Ret.prototype.obj = function (obj, id) {
  * @param {boolean} bl 布尔结果
  * @param {string} tip 提示信息
  * @param {string} id 消息ID
- * @returns {object} 布尔响应格式
+ * @returns {object} 布尔响应格式对象
  */
-Ret.prototype.bl = function (bl, _tip, id) {
-  var tip = _tip || (bl ? this.config.success_message : this.config.error_message);
+Ret.prototype.bl = function (bl, tip, id) {
   return this.body({
     bl,
-    tip
+    tip: tip || (bl ? this.config.success_message : this.config.error_message)
   }, null, id);
 };
 
@@ -270,7 +267,7 @@ Ret.prototype.add = function (res, key, value) {
 /**
  * 解析响应
  * @param {object} res 响应对象
- * @returns {object} 解析后的格式
+ * @returns {object} 解析后的响应格式对象
  */
 Ret.prototype.parse = function (res) {
   let error;
@@ -321,7 +318,8 @@ Ret.prototype.parse = function (res) {
 
 /**
  * 设置响应格式
- * @param {string} format 响应格式
+ * @param {string} format 响应格式, 可选值: json, json-rpc, json-rpc3, restful
+ * @returns {Ret} 响应对象
  */
 Ret.prototype.setFormat = function (format) {
   switch (format?.toLowerCase()) {

package/lib/string.js

@@ -89,14 +89,14 @@ String.prototype.aesDecode = function (key, iv) {
 
 /**
  * 获取字符串的拼音
- * @returns {string}
+ * @returns {string} 拼音
  */
 String.prototype.pinyin = function () {
   return pinyin(this).join('');
 };
 /**
  * 获取字符串的拼音
- * @returns {string} 拼音
+ * @returns {string} 拼音首字母
  */
 String.prototype.pinyinS = function () {
   let arr = pinyin(this);
@@ -251,19 +251,16 @@ String.prototype.right = function (delimiter, retain) {
 };
 /**
  * 取文本之间
- * @param {string} leftDelimiter 索引的左边字符
- * @param {string} rightDelimiter 索引的右边字符
- * @param left_delimiter
- * @param left_deli
- * @param right_delimiter
- * @param right_deli
+ * @param {string} left_str 索引的左边字符
+ * @param {string} right_str 索引的右边字符
  * @param {boolean} retain 当索引字符不存在时是否保留右边
  * @returns {string} 截取后的字符串
  */
-String.prototype.between = function (left_deli, right_deli, retain) {
-  let str = this.right(left_delimiter, retain);
-  return str.left(right_delimiter, retain);
+String.prototype.between = function (left_str, right_str, retain) {
+  let str = this.right(left_str, retain);
+  return str.left(right_str, retain);
 };
+
 /**
  * 替换所有字符串
  * @param {string} search 被替换的字符串
@@ -473,7 +470,7 @@ String.prototype.toObj = function () {
 /**
  * 转正则表达式
  * @param {string} mode = [g|i|gi] 转换方式, g为全部, i为不区分大小写
- * @returns {Regex} 返回正则对象
+ * @returns {RegExp} 返回正则对象
  */
 String.prototype.toRx = function (mode) {
   var _mode = mode || 'gi';
@@ -490,95 +487,112 @@ String.prototype.toRx = function (mode) {
 // 验证函数集合
 const validators = {
   /**
-   *
-   * @param value
+   * 验证手机号字符串
+   * @param {string} value 手机号字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   phone: (value) => /^0?(13|14|15|16|17|18|19)[0-9]{9}$/.test(value),
   /**
-   *
-   * @param value
+   * 验证邮箱字符串
+   * @param {string} value 邮箱字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   email: (value) => /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/.test(value),
   /**
-   *
-   * @param value
+   * 验证用户名字符串
+   * @param {string} value 用户名字符串 
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   username: (value) => /^[a-z0-9A-Z_]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证密码字符串
+   * @param {string} value 密码字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   password: (value) => /^[a-z0-9A-Z]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证URL字符串
+   * @param {string} value URL字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   url: (value) =>
     /^((https|http|ftp|rtsp|mms)?:\/\/)[^\s]+/gi.test(value),
   /**
-   *
-   * @param value
+   * 验证日期字符串
+   * @param {string} value 日期字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   date: (value) =>
     /^\d{4}(-|\/|\.)(0[1-9]|1[012]|[1-9])(-|\/|\.)([12][0-9]|0[1-9]|3[01]|[1-9])$/.test(value),
   /**
-   *
-   * @param value
+   * 验证时间字符串
+   * @param {string} value 时间字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   time: (value) => /^([01][0-9]|2[0-3]):([0-4][0-9]|5[0-9])(:([0-4][0-9]|5[0-9]))?$/.test(value),
   /**
-   *
-   * @param value
+   * 验证日期时间字符串
+   * @param {string} value 日期时间字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   datetime: (value) =>
     new RegExp('^\\d{4}(-|\\/|\\.)(0[1-9]|1[012]|[1-9])(-|\\/|\\.)([12][0-9]|0[1-9]|3[01]|[1-9]) ' +
     '([01][0-9]|2[0-3]):([0-4][0-9]|5[0-9])(:([0-4][0-9]|5[0-9]))?$').test(value),
   /**
-   *
-   * @param value
+   * 验证ISO日期字符串
+   * @param {string} value 日期字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   dateiso: (value) =>
     new RegExp('^\\d{4}-(0[1-9]|1[012]|[1-9])-([12][0-9]|0[1-9]|3[01]|[1-9])' +
     '(([01][0-9]|2[0-3]):([0-4][0-9]|5[0-9])(:([0-4][0-9]|5[0-9]))?)?$').test(value),
   /**
-   *
-   * @param value
+   * 验证数字字符串
+   * @param {string} value 数字字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   number: (value) =>
     /^[1-9]+[0-9]*(\.[0-9]+|[0-9]*)|0\.[0-9]+|0$/.test(value),
   /**
-   *
-   * @param value
+   * 验证英文字符串
+   * @param {string} value 英文字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   en: (value) => /^[a-zA-Z]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证数字字符串
+   * @param {string} value 数字字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   num: (value) => /^[0-9]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证数字字符串
+   * @param {string} value 数字字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   digits: (value) => /^[0-9]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证中文字符串
+   * @param {string} value 中文字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   ch: (value) => /^[\u4e00-\u9fa5]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证中文字符串
+   * @param {string} value 中文字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   chs: (value) => /^[\u4e00-\u9fa5]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证中文字符串
+   * @param {string} value 中文字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   chinese: (value) => /^[\u4e00-\u9fa5]+$/.test(value),
   /**
-   *
-   * @param value
+   * 验证身份证号字符串
+   * @param {string} value 身份证号字符串
+   * @returns {boolean} 验证通过返回true, 失败返回false
    */
   idcard: (value) =>
     new RegExp('^[1-9]\\d{5}(18|19|20)\\d{2}((0[1-9])|(1[0-2]))' +

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mm_expand",
-	"version": "2.3.7",
+	"version": "2.3.9",
 	"description": "超级美眉原型函数扩展模块 - 增强的字符串、数组、对象、日期操作，具备错误预防功能并简化业务逻辑",
 	"main": "index.js",
 	"scripts": {