mm_expand 2.3.3 → 2.3.5

package/lib/string.js

@@ -1,29 +1,21 @@
 /**
- * @description 字符串工具类，用于扩展String原型
+ * 字符串工具类，用于扩展String原型
  */
-const {
-  XMLParser
-} = require('fast-xml-parser');
-
 const json5 = require('json5');
 const pinyin = require('pinyinlite');
-const {
-  createHash,
-  createCipheriv,
-  createDecipheriv
-} = require('crypto');
+const { createHash, createCipheriv, create_deci: create_deci } = require('crypto');
 
 /**
- * @description form-data转对象
+ * form-data转对象
  * @returns {object} 转换后的对象
  */
 String.prototype.toQuery = function () {
   const result = {};
-  const str = this + '';
-  const parts = str.split('?');
+  let str = this + '';
+  let parts = str.split('?');
 
   if (parts.length > 1) {
-    const params = parts[1].split('&');
+    let params = parts[1].split('&');
     for (let i = 0; i < params.length; i++) {
       const [key, value] = params[i].split('=');
       result[key] = value;
@@ -34,17 +26,17 @@ String.prototype.toQuery = function () {
 };
 
 /**
- * @description MD5加密
+ * MD5加密
  * @returns {string} 加密后的字符串
  */
 String.prototype.md5 = function () {
-  const hash = createHash('md5');
+  let hash = createHash('md5');
   hash.update(this + '');
   return hash.digest('hex');
 };
 
 /**
- * @description aes加密
+ * aes加密
  * @param {string} key - 必须为32位私钥
  * @param {string} iv - 初始向量
  * @returns {string} 加密后的字符串
@@ -54,12 +46,12 @@ String.prototype.aesEncode = function (key, iv) {
     throw new Error('密钥必须为32位');
   }
 
-  iv = iv || '';
-  const encoding = 'base64';
+  var _iv = iv || '';
+  let encoding = 'base64';
   const chunks = [];
 
   try {
-    const cipher = createCipheriv('aes-256-ecb', key, iv);
+    let cipher = createCipheriv('aes-256-ecb', key, _iv);
     cipher.setAutoPadding(true);
     chunks.push(cipher.update(this + '', 'utf8', encoding));
     chunks.push(cipher.final(encoding));
@@ -70,7 +62,7 @@ String.prototype.aesEncode = function (key, iv) {
 };
 
 /**
- * @description aes解密
+ * aes解密
  * @param {string} key - 必须为32位私钥
  * @param {string} iv - 初始向量
  * @returns {string} 解密后的字符串
@@ -80,12 +72,12 @@ String.prototype.aesDecode = function (key, iv) {
     throw new Error('密钥必须为32位');
   }
 
-  iv = iv || '';
-  const encoding = 'utf8';
+  var _iv = iv || '';
+  let encoding = 'utf8';
   const chunks = [];
 
   try {
-    const decipher = createDecipheriv('aes-256-ecb', key, iv);
+    let decipher = create_deci('aes-256-ecb', key, _iv);
     decipher.setAutoPadding(true);
     chunks.push(decipher.update(this + '', 'base64', encoding));
     chunks.push(decipher.final(encoding));
@@ -96,25 +88,25 @@ String.prototype.aesDecode = function (key, iv) {
 };
 
 /**
- * @description 获取字符串的拼音
+ * 获取字符串的拼音
  * @returns {string}
  */
 String.prototype.pinyin = function () {
   return pinyin(this).join('');
 };
 /**
- * @description 获取字符串的拼音
+ * 获取字符串的拼音
  * @returns {string} 拼音
  */
 String.prototype.pinyinS = function () {
-  const arr = pinyin(this);
+  let arr = pinyin(this);
   let result = '';
-  const len = arr.length;
+  let len = arr.length;
 
   for (let i = 0; i < len; i++) {
-    const ar = arr[i];
+    let ar = arr[i];
     if (ar.length > 0) {
-      const char = ar[0];
+      let char = ar[0];
       result += char.charAt(0).toLocaleUpperCase() + char.substring(1);
     } else {
       result += ' ';
@@ -124,7 +116,7 @@ String.prototype.pinyinS = function () {
   return result;
 };
 /**
- * @description 将json字符串转为对象
+ * 将json字符串转为对象
  * @returns {object} 对象
  */
 String.prototype.toJson = function () {
@@ -135,38 +127,38 @@ String.prototype.toJson = function () {
   }
 };
 /**
- * @description 将xml字符串转为对象
+ * 将xml字符串转为对象
  * @returns {object} 对象
  */
 String.prototype.toXml = function () {
   try {
-    const parser = new XMLParser();
+    const parser = new XmlParser();
     return parser.parse(this);
   } catch (error) {
     throw new Error('xml反序列化错误！', error);
   }
 };
 /**
- * @description 将url字符串转为对象
+ * 将url字符串转为对象
  * @returns {object} 对象
  */
 String.prototype.toUrl = function () {
-  const parts = this.split('&');
+  let parts = this.split('&');
   const url = {};
 
-  parts.forEach(function (item) {
-    const item_parts = item.split('=');
-    if (item_parts.length > 1) {
-      url[item_parts[0]] = decodeURIComponent(item_parts[1]);
+  parts.forEach((item) => {
+    var parts = item.split('=');
+    if (parts.length > 1) {
+      url[parts[0]] = decodeURIComponent(parts[1]);
     } else {
-      url[item_parts[0]] = null;
+      url[parts[0]] = null;
     }
   });
 
   return url;
 };
 /**
- * @description 删除首字符
+ * 删除首字符
  * @param {string} chars  要删除的字符, 默认删除空字符
  * @returns {string} 删除后字符串
  */
@@ -184,7 +176,7 @@ String.prototype.startTrim = function (chars) {
   return this.replace(regex, '');
 };
 /**
- * @description 删除尾字符
+ * 删除尾字符
  * @param {string} chars 要删除的字符, 默认删除空字符
  * @returns {string} 删除后字符串
  */
@@ -202,7 +194,7 @@ String.prototype.endTrim = function (chars) {
   return this.replace(regex, '');
 };
 /**
- * @description 删除首尾字符
+ * 删除首尾字符
  * @param {string} chars 要删除的字符, 默认删除空字符
  * @returns {string} 删除后字符串
  */
@@ -220,13 +212,13 @@ String.prototype.trim = function (chars) {
   return this.replace(regex, '');
 };
 /**
- * @description 取文本左边
+ * 取文本左边
  * @param {string} delimiter 分割字符
  * @param {boolean} retain 当索引字符不存在时是否保留左边
  * @returns {string} 截取后的字符串
  */
 String.prototype.left = function (delimiter, retain) {
-  const index = this.indexOf(delimiter);
+  let index = this.indexOf(delimiter);
 
   if (index === -1) {
     if (retain) {
@@ -239,13 +231,13 @@ String.prototype.left = function (delimiter, retain) {
   }
 };
 /**
- * @description 取文本右边
+ * 取文本右边
  * @param {string} delimiter 分割字符
  * @param {boolean} retain 当索引字符不存在时是否保留右边
  * @returns {string} 截取后的字符串
  */
 String.prototype.right = function (delimiter, retain) {
-  const index = this.indexOf(delimiter);
+  let index = this.indexOf(delimiter);
 
   if (index === -1) {
     if (retain) {
@@ -258,27 +250,29 @@ String.prototype.right = function (delimiter, retain) {
   }
 };
 /**
- * @description 取文本之间
+ * 取文本之间
  * @param {string} leftDelimiter 索引的左边字符
  * @param {string} rightDelimiter 索引的右边字符
  * @param left_delimiter
+ * @param left_deli
  * @param right_delimiter
+ * @param right_deli
  * @param {boolean} retain 当索引字符不存在时是否保留右边
  * @returns {string} 截取后的字符串
  */
-String.prototype.between = function (left_delimiter, right_delimiter, retain) {
-  const str = this.right(left_delimiter, retain);
+String.prototype.between = function (left_deli, right_deli, retain) {
+  let str = this.right(left_delimiter, retain);
   return str.left(right_delimiter, retain);
 };
 /**
- * @description 替换所有字符串
+ * 替换所有字符串
  * @param {string} search 被替换的字符串
  * @param {string} replacement 替换后的字符串
  * @returns {string} 替换后的字符串
  */
 String.prototype.replaceAll = function (search, replacement) {
   let txt = this + '';
-  const value = replacement || '';
+  let value = replacement || '';
 
   while (txt.indexOf(search) !== -1) {
     txt = txt.replace(search, value);
@@ -288,25 +282,25 @@ String.prototype.replaceAll = function (search, replacement) {
 };
 
 /**
- * @description 是否含字符串
+ * 是否含字符串
  * @param {string} pattern = [word|word*|*word|*word*]字符串, 支持*号匹配, 前*表示匹配后面字符串, 后*表示匹配前面字符串,
   前后*表示匹配包含字符串
  * @returns {boolean} 包含返回true, 不包含返回false
  */
 String.prototype.has = function (pattern) {
-  const str = this + '';
+  let str = this + '';
 
   if (str === pattern) {
     return true;
   } else if (pattern.startsWith('*')) {
-    const clean = pattern.replaceAll('*', '');
+    let clean = pattern.replaceAll('*', '');
     if (pattern.endsWith('*')) {
       return str.indexOf(clean) !== -1;
     } else {
       return str.endsWith(clean);
     }
   } else if (pattern.endsWith('*')) {
-    const clean = pattern.replaceAll('*', '');
+    let clean = pattern.replaceAll('*', '');
     return str.startsWith(clean);
   }
   else {
@@ -315,7 +309,7 @@ String.prototype.has = function (pattern) {
 };
 
 /**
- * @description 转为时间对象
+ * 转为时间对象
  * @returns {Date} 时间对象
  */
 String.prototype.toTime = function () {
@@ -340,51 +334,51 @@ String.prototype.toTime = function () {
   return date;
 };
 /**
- * @description 转为时间戳
+ * 转为时间戳
  * @returns {number} 返回时间戳
  */
 String.prototype.stamp = function () {
-  const date = this.toTime();
+  let date = this.toTime();
   return typeof date.stamp === 'function' ? date.stamp() : Math.floor(date.getTime() / 1000);
 };
 /**
- * @description 转为时间格式字符串
+ * 转为时间格式字符串
  * @param {string} format 转换的格式
  * @returns {string} 时间格式字符串
  */
 String.prototype.toTimeFormat = function (format) {
-  const date = this.toTime();
+  let date = this.toTime();
   return typeof date.toStr === 'function' ? date.toStr(format) : date.toISOString();
 };
 /**
- * @description 转为时间格式字符串
+ * 转为时间格式字符串
  * @param {string} format 转换的格式
  * @returns {string} 时间格式字符串
  */
 String.prototype.toTimeStr = function (format) {
-  const date = this.toTime();
+  let date = this.toTime();
   return typeof date.toStr === 'function' ? date.toStr(format) : date.toISOString();
 };
 /**
- * @description 转为时间戳
+ * 转为时间戳
  * @returns {number} 时间戳
  */
 String.prototype.toTimestamp = function () {
-  const date = this.toTime();
+  let date = this.toTime();
   return typeof date.stamp === 'function' ? date.stamp() : Math.floor(date.getTime() / 1000);
 };
 
 /**
- * @description 时间增加秒数
+ * 时间增加秒数
  * @param {number} seconds 增加秒数
  * @param {string} format 转换的格式
  * @returns {string | Date} 时间格式字符串
  */
 String.prototype.addSeconds = function (seconds, format) {
-  const date = this.toTime();
+  let date = this.toTime();
 
   if (typeof date.addSeconds === 'function') {
-    const result = date.addSeconds(seconds);
+    let result = date.addSeconds(seconds);
 
     if (format && typeof result.toStr === 'function') {
       return result.toStr(format);
@@ -394,21 +388,21 @@ String.prototype.addSeconds = function (seconds, format) {
   }
 
   // 降级处理
-  const new_time = new Date(date.getTime() + seconds * 1000);
-  return format ? new_time.toISOString() : new_time;
+  const newTime = new Date(date.getTime() + seconds * 1000);
+  return format ? newTime.toISOString() : newTime;
 };
 
 /**
- * @description 时间增加天数
+ * 时间增加天数
  * @param {number} days 增加天数
  * @param {string} format 转换的格式
  * @returns {string | Date} 时间格式字符串
  */
 String.prototype.addDays = function (days, format) {
-  const date = this.toTime();
+  let date = this.toTime();
 
   if (typeof date.addDays === 'function') {
-    const result = date.addDays(days);
+    let result = date.addDays(days);
 
     if (format && typeof result.toStr === 'function') {
       return result.toStr(format);
@@ -418,16 +412,16 @@ String.prototype.addDays = function (days, format) {
   }
 
   // 降级处理
-  const new_time = new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
-  return format ? new_time.toISOString() : new_time;
+  const newTime = new Date(date.getTime() + days * 24 * 60 * 60 * 1000);
+  return format ? newTime.toISOString() : newTime;
 };
 
 /**
- * @description 转为数组
+ * 转为数组
  * @returns {Array} 数组
  */
 String.prototype.toArr = function () {
-  const str = this.trim();
+  let str = this.trim();
 
   try {
     if (str.startsWith('[') && str.endsWith(']')) {
@@ -442,12 +436,12 @@ String.prototype.toArr = function () {
 };
 
 /**
- * @description 转为数值
+ * 转为数值
  * @param {number} precision 精度
  * @returns {number} 数值
  */
 String.prototype.toNum = function (precision) {
-  const val = parseFloat(this);
+  let val = parseFloat(this);
 
   if (isNaN(val)) {
     return 0;
@@ -460,11 +454,11 @@ String.prototype.toNum = function (precision) {
   return val;
 };
 /**
- * @description 转为对象
+ * 转为对象
  * @returns {object} 对象
  */
 String.prototype.toObj = function () {
-  const str = this.trim();
+  let str = this.trim();
 
   try {
     if (str.startsWith('{') && str.endsWith('}')) {
@@ -477,17 +471,17 @@ String.prototype.toObj = function () {
   return {};
 };
 /**
- * @description 转正则表达式
+ * 转正则表达式
  * @param {string} mode = [g|i|gi] 转换方式, g为全部, i为不区分大小写
  * @returns {Regex} 返回正则对象
  */
 String.prototype.toRx = function (mode) {
-  mode = mode || 'gi';
+  var _mode = mode || 'gi';
 
   try {
     // 转义正则特殊字符
-    const pattern = this.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    return new RegExp(pattern, mode);
+    let pattern = this.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(pattern, _mode);
   } catch (error) {
     throw new Error('字符串转正则错误:', error);
   }
@@ -592,15 +586,15 @@ const validators = {
 };
 
 /**
- * @description 验证字符串格式
+ * 验证字符串格式
  * @param {string} format 所属格式
  * @returns {boolean} 验证通过返回true, 失败返回false
  */
 String.prototype.validate = function (format) {
-  const value = this + '';
-  const format_key = format.toLowerCase();
+  let value = this + '';
+  let format_key = format.toLowerCase();
 
-  const validator = validators[format_key];
+  let validator = validators[format_key];
   if (!validator) {
     throw new Error('输入的验证类型错误');
   }
@@ -609,7 +603,7 @@ String.prototype.validate = function (format) {
 };
 
 /**
- * @description 模板替换
+ * 模板替换
  * @param {object} data 替换的数据
  * @param {RegExp} regex 正则表达式
  * @returns {string} 替换后的字符串
@@ -623,8 +617,8 @@ String.prototype.tpl = function (data, regex) {
   }
 
   // 处理模板字符串
-  compiled = compiled.replace(regex || /\$\{(.*?)\}/g, function (match, key) {
-    const keys = key.trim().split('.');
+  compiled = compiled.replace(regex || /\$\{(.*?)\}/g, (match, key) => {
+    let keys = key.trim().split('.');
     let val = data;
 
     for (let i = 0; i < keys.length; i++) {
@@ -641,7 +635,7 @@ String.prototype.tpl = function (data, regex) {
 };
 
 /**
- * @description 导出String原型扩展
+ * 导出String原型扩展
  */
 module.exports = {
   String

package/lib/timer.js

@@ -1,7 +1,7 @@
 const { Base } = require('./base.js');
 
 /**
- * @description 定时器类
+ * 定时器类
  */
 class Timer extends Base {
   static config = {
@@ -12,7 +12,7 @@ class Timer extends Base {
     remove_faulty_tasks: false
   };
   /**
-   * @description 定时器构造函数
+   * 定时器构造函数
    * @param {object} config 配置参数
    */
   constructor(config) {
@@ -27,7 +27,7 @@ class Timer extends Base {
 }
 
 /**
- * @description 执行所有定时任务（并行执行，性能优化版）
+ * 执行所有定时任务（并行执行，性能优化版）
  * @returns {Promise<void>} Promise对象，支持异步操作
  */
 Timer.prototype.run = async function () {
@@ -138,7 +138,7 @@ Timer.prototype._handleTaskError = function (error, obj, index) {
 };
 
 /**
- * @description 启动
+ * 启动
  */
 Timer.prototype.start = function () {
   if (!this.core) {
@@ -148,7 +148,7 @@ Timer.prototype.start = function () {
 };
 
 /**
- * @description 结束
+ * 结束
  */
 Timer.prototype.end = function () {
   clearInterval(this.core);
@@ -156,7 +156,7 @@ Timer.prototype.end = function () {
 };
 
 /**
- * @description 任务模型
+ * 任务模型
  * @param {object} obj 任务对象
  * @returns {object} 任务模型对象
  */
@@ -169,7 +169,7 @@ Timer.prototype.model = function (obj) {
   return {
     name: 'anonymous',
     run: function () { }, ...obj
-  }
+  };
 };
 
 /**
@@ -189,7 +189,7 @@ Timer.prototype.addObj = function (obj) {
 };
 
 /**
- * @description 获取任务名称
+ * 获取任务名称
  * @param {Function} func 任务函数
  * @param {string} [name] 可选的任务名称
  * @returns {string} 任务名称
@@ -211,7 +211,7 @@ Timer.prototype._getTaskName = function (func, name) {
 };
 
 /**
- * @description 添加函数任务
+ * 添加函数任务
  * @param {Function} func 任务函数
  * @param {string} [name] 可选的任务名称
  * @private
@@ -226,7 +226,7 @@ Timer.prototype._addFunc = function (func, name) {
 };
 
 /**
- * @description 添加定时执行任务
+ * 添加定时执行任务
  * @param {Function | object} obj_or_func 要添加的任务函数或对象
  * @param {string} [name] 可选的任务名称，用于标识任务
  */
@@ -262,7 +262,7 @@ Timer.prototype.del = function (name) {
 };
 
 /**
- * @description 设置定时器
+ * 设置定时器
  * @param {Function} func 要执行的函数
  * @param {number} delay 延迟时间（毫秒）
  * @returns {object} 定时器ID
@@ -279,7 +279,7 @@ Timer.prototype.setTimeout = function (func, delay) {
 };
 
 /**
- * @description 清除定时器
+ * 清除定时器
  * @param {object} timer_id 定时器ID
  */
 Timer.prototype.clearTimeout = function (timer_id) {
@@ -290,7 +290,7 @@ Timer.prototype.clearTimeout = function (timer_id) {
 };
 
 /**
- * @description 设置间隔定时器
+ * 设置间隔定时器
  * @param {Function} func 要执行的函数
  * @param {number} interval 间隔时间（毫秒）
  * @returns {object} 定时器ID
@@ -307,7 +307,7 @@ Timer.prototype.setInterval = function (func, interval) {
 };
 
 /**
- * @description 清除间隔定时器
+ * 清除间隔定时器
  * @param {object} timer_id 定时器ID
  */
 Timer.prototype.clearInterval = function (timer_id) {
@@ -318,7 +318,7 @@ Timer.prototype.clearInterval = function (timer_id) {
 };
 
 /**
- * @description 移除有问题的任务
+ * 移除有问题的任务
  * @param {number} index 任务索引
  * @param {string} task_name 任务名称
  * @private