util-helpers 4.15.2 → 4.16.0

package/dist/util-helpers.js

@@ -537,7 +537,7 @@
   }
 
   // eslint-disable-next-line no-undef
-  var version = "4.15.2";
+  var version = "4.16.0";
 
   /**
    * 打印警告信息
@@ -1542,6 +1542,31 @@
   // 最小安全数字
   var MIN_SAFE_INTEGER = Number.MIN_SAFE_INTEGER || -9007199254740991;
 
+  /**
+   * 检查值是否为Blob对象<br/><br/>
+   * 
+   * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+   *
+   * @static
+   * @alias module:Type.isBlob
+   * @since 4.16.0
+   * @param {*} value 检查值
+   * @returns {boolean} 是否为Blob对象
+   * @example
+   *
+   * isBlob(new Blob(['a']))
+   * // => true
+   *
+   * isBlob({})
+   * // => false
+   *
+   * isBlob('2012')
+   * // => false
+   */
+  function isBlob(value) {
+    return isType(value, 'Blob');
+  }
+
   /**
    * 检查值是否为Object
    *
@@ -2025,20 +2050,24 @@
    * @returns {string} 处理后的字符
    * @example
    *
-   * // 手机号
+   * // 手机号 前3后4
    * replaceChar('13000000000'); // 130****0000
    *
-   * // 身份证
-   * replaceChar('130701199310302288'); // 130***********2288
+   * // 身份证 前6后4
+   * replaceChar('130701199310302288', { start: 6, end: -4 }); // 130701********2288
    *
-   * // 邮箱
+   * // 邮箱 @前两位
    * const email = '12345@qq.com'
+   * const emailAtIndex = email.indexOf('@');
+   * replaceChar(email, { start: emailAtIndex - 2, end: emailAtIndex }); // 123**@qq.com
+   * // 邮箱 前2和@后面内容，固定替换字符4位
    * replaceChar(email, {start: 2, end: email.indexOf('@'), repeat: 4}); // 12****@qq.com
    *
-   * // 银行卡号
+   * // 银行卡号 只展示后4位，固定替换字符4位
    * replaceChar('6228480402564890018', {start: 0, end: -4, repeat: 4}); // ****0018
-   *
-   * // 带格式的银行卡号，忽略空字符串
+   * // 银行卡号 前6后4
+   * replaceChar('6228480402564890018', { start: 6, end: -4 }); // 622848*********0018
+   * // 银行卡号 前4后3 忽略格式的空格
    * replaceChar('6228 4804 0256 4890 018', {start: 4, end: -4, exclude: ' '}); // 6228 **** **** **** 018
    *
    * // 用户名
@@ -2211,8 +2240,9 @@
   }
 
   /**
-   * 数字转中文数字
-   * 不在安全数字 -9007199254740991～9007199254740991 内，处理会有异常
+   * 数字转中文数字<br/><br/>
+   * 
+   * 如果数字不在安全数字 -9007199254740991～9007199254740991 范围内，处理会有异常。
    *
    * @static
    * @alias module:Processor.numberToChinese
@@ -2419,7 +2449,7 @@
    * @since 4.0.0
    * @see 参考 {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
    * @param {string} id 身份证号码，支持15位
-   * @returns {null|IdCardInfo} null 或 省份、生日、性别，省/市/区/年/月/日/性别编码
+   * @returns {IdCardInfo | null} 省份、生日、性别，省/市/区/年/月/日/性别编码。如果解析失败将返回 null 。
    * @example
    * 
    * parseIdCard('123456789123456'); // null
@@ -2481,37 +2511,63 @@
     };
   }
 
-  //  file、blob文件如何预览图片？
-  //  方法1：将file或者blob类型文件转成base64数据，再作为src赋值给img标签
-  //  方法2：使用 window.URL.createObjectURL(blob) 为blob、file 创建一个指向该参数对象的URL
+  var FileReaderMethodMap = {
+    arrayBuffer: 'readAsArrayBuffer',
+    binaryString: 'readAsBinaryString',
+    dataURL: 'readAsDataURL',
+    text: 'readAsText'
+  };
+
+  /**
+   * @overload
+   * @param {Blob} blob
+   * @param {'arrayBuffer'} type
+   * @returns {Promise<ArrayBuffer>}
+   */
+
+  /**
+   * @overload
+   * @param {Blob} blob
+   * @param {'binaryString'|'binaryString'|'dataURL'|'text'} [type='dataURL']
+   * @returns {Promise<string>}
+   */
 
   /**
-   * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串。
+   * 读取 Blob 或 File 对象<br/><br/>
+   * 
+   * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
    *
    * @static
-   * @alias module:Processor.blobToDataURL
-   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
-   * @since 4.1.0
+   * @alias module:Processor.fileReader
+   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader|FileReader}
+   * @since 4.16.0
    * @param {Blob} blob Blob 或 File 对象
-   * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
+   * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] Blob 或 File 对象
+   * @returns {Promise<string|ArrayBuffer>} 文件的内容
    * @example
    * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
    * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
    *
-   * blobToDataURL(htmlBlob).then(data=>{
+   * fileReader(htmlBlob).then(data=>{
    *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
    * });
    *
    * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
    *
-   * blobToDataURL(textBlob).then(data=>{
-   *   console.log(data); // data:text/plain;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+   * fileReader(textBlob, 'text').then(data=>{
+   *   console.log(data); // <a id="a"><b id="b">hey!</b></a>
    * });
    */
-  function blobToDataURL(blob) {
+  function fileReader(blob) {
+    var type = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'dataURL';
+    var method = FileReaderMethodMap[type];
+    if (!method) {
+      method = FileReaderMethodMap.dataURL;
+    }
     return new Promise(function (resolve, reject) {
       var reader = new FileReader();
-      reader.readAsDataURL(blob);
+      // @ts-ignore
+      reader[method](blob);
       // @ts-ignore
       reader.onload = function () {
         return resolve(reader.result);
@@ -2522,6 +2578,39 @@
     });
   }
 
+  //  file、blob文件如何预览图片？
+
+  /**
+   * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串<br/><br/>
+   * 
+   * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+   *
+   * @static
+   * @alias module:Processor.blobToDataURL
+   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
+   * @since 4.1.0
+   * @ignore
+   * @deprecated 请使用 `fileReader` 方法
+   * @param {Blob} blob Blob 或 File 对象
+   * @returns {Promise<string>} data:URL 格式的 Base64 字符串。
+   * @example
+   * const aFileParts = ['<a id="a"><b id="b">hey!</b></a>']; // 一个包含DOMString的数组
+   * const htmlBlob = new Blob(aFileParts, { type: 'text/html' }); // 得到 blob
+   *
+   * blobToDataURL(htmlBlob).then(data=>{
+   *   console.log(data); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+   * });
+   *
+   * const textBlob = new Blob(aFileParts, { type: 'text/plain' });
+   *
+   * blobToDataURL(textBlob).then(data=>{
+   *   console.log(data); // data:text/plain;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+   * });
+   */
+  function blobToDataURL(blob) {
+    return fileReader(blob);
+  }
+
   /**
    * 将 DataURL 转为 Blob 对象
    *
@@ -2536,17 +2625,18 @@
    * dataURLToBlob(dataurl); // Blob {size: 32, type: 'text/html'}
    */
   function dataURLToBlob(dataurl) {
-    var arr = dataurl.split(',');
-    // @ts-ignore
-    var mime = arr[0].match(/:(.*?);/)[1];
-    var bstr = atob(arr[1]);
+    var parts = dataurl.split(',');
+    var meta = parts[0].substring(5).split(';');
+    var type = meta[0];
+    var decoder = meta.indexOf('base64') !== -1 ? atob : decodeURIComponent;
+    var bstr = decoder(parts[1]);
     var n = bstr.length;
     var u8arr = new Uint8Array(n);
     while (n--) {
       u8arr[n] = bstr.charCodeAt(n);
     }
     return new Blob([u8arr], {
-      type: mime
+      type: type
     });
   }
 
@@ -2580,11 +2670,34 @@
     return "data:".concat(mimetype).concat(base64 ? ';base64' : '', ",").concat(data);
   }
 
-  // TODO: 函数重载，类型参照 Date
+  /**
+   * @overload
+   * @return {Date}
+   */
+
+  /**
+   * @overload
+   * @param {number | string | Date} value Unix时间戳、时间戳字符串 dateString 、Date 日期对象
+   * @return {Date}
+   */
+
+  /**
+   * @overload
+   * @param {number} year 表示年份的整数值。0 到 99 会被映射至 1900 年至 1999 年，其他值代表实际年份。
+   * @param {number} monthIndex 表示月份的整数值，从 0（1 月）到 11（12 月）。
+   * @param {number} [date] 表示一个月中的第几天的整数值，从 1 开始。默认值为 1。
+   * @param {number} [hours] 表示一天中的小时数的整数值 (24 小时制)。默认值为 0（午夜）。
+   * @param {number} [minutes] 表示一个完整时间（如 01:10:00）中的分钟部分的整数值。默认值为 0。
+   * @param {number} [seconds] 表示一个完整时间（如 01:10:00）中的秒部分的整数值。默认值为 0。
+   * @param {number} [ms] 表示一个完整时间的毫秒部分的整数值。默认值为 0。
+   * @return {Date}
+   */
 
   /**
-   * 创建一个 Date 实例日期对象，同 new Date() 。<br/>
-   * 规避了苹果设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+   * 创建一个 Date 实例日期对象，同 <a href="https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date#%E5%8F%82%E6%95%B0">new Date()</a> <br/><br/>
+   * 
+   * 规避了苹果设备浏览器不支持部分格式（例如，YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。<br/>
+   * 如果参数为 undefined 正常返回 Date 。
    *
    * @static
    * @alias module:Processor.safeDate
@@ -2601,8 +2714,6 @@
    * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
    * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
    * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
-   * 
-   *
    */
   function safeDate(value) {
     var safeValue = typeof value === 'string' ? value.replace(/[\\.-]/g, '/') : value;
@@ -2613,9 +2724,7 @@
       // @ts-ignore
       return _construct(Date, [safeValue].concat(args));
     }
-
-    // @ts-ignore
-    return isNil(safeValue) ? new Date() : new Date(safeValue);
+    return typeof safeValue === 'undefined' ? new Date() : new Date(safeValue);
   }
 
   /**
@@ -2698,352 +2807,110 @@
   }
 
   /**
-   * 转换字段名，返回一个转换字段后的值，不改变原值。
-   * 
+   * 精确乘法，支持多个数相乘，乘数默认为 1 。
+   *
    * @static
-   * @alias module:Processor.transformFieldNames
-   * @since 4.14.0
-   * @template {*} D
-   * @template {Record<string, keyof D>} F
-   * @template {string} C
-   * @param {D[]} data 对象数组。如果是树结构数据，需要指定第三个参数 childrenField
-   * @param {F} fieldNames 字段名映射
-   * @param {C} [childrenField] 子级数据字段名
-   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {import('./transformFieldNames.type.js').TransformFieldNames<D, F, C>}
+   * @alias module:Math.times
+   * @since 3.1.0
+   * @param {...number|string} nums 相乘的数
+   * @returns {number} 乘积
    * @example
+   *
+   * times(3, 0.6); // 1.8
+   * times(3, 0.6, 2); // 3.6
+   * times(3, 0.6, 2, 10); // 36
    * 
-   * const options = [{code: '1', name: 'one'},{code:'2', name:'two'}];
-   * const newOptions = transformFieldNames(options, {label: 'name', value: 'code'});
-   * // [{value: '1', label: 'one'},{value:'2', label:'two'}]
-   * 
-   * // 嵌套数据，指定子级字段名 children
-   * const options2 = [{code: '1', name: 'one'},{code:'2', name:'two', children: [{code:'2-1', name:'two-one', children: [{code: '2-1-1', name:'two-one-one'}]}]}];
-   * const newOptions2 = transformFieldNames(options2, {label: 'name', value: 'code'}, 'children');
-   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one', children: [{value: '2-1-1', label:'two-one-one'}]}]}]
-   * 
-   * const options3 = [{code: '1', name: 'one'},{code:'2', name:'two', childs: [{code:'2-1', name:'two-one'}]}];
-   * const newOptions3 = transformFieldNames(options3, {label: 'name', value: 'code'}, 'childs');
-   * // [{value: '1', label: 'one'},{value:'2', label:'two', childs: [{value: '2-1', label:'two-one'}]}]
-   * 
-   * // 嵌套数据，并替换子集字段名
-   * const newOptions4 = transformFieldNames(options3, {label: 'name', value: 'code', children: 'childs'}, 'childs');
-   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one'}]}]
    */
-  function transformFieldNames(data, fieldNames, childrenField) {
-    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
-    if (!Array.isArray(data)) {
-      return data;
-    }
-    if (data.length <= 0) {
-      // @ts-ignore
-      return [];
+  function times() {
+    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+      nums[_key] = arguments[_key];
     }
-
-    /**
-     * 递归处理字段名
-     * 
-     * @param {Array.<object>} arr 列表数据
-     * @returns {*}
-     */
-    function recusion(arr) {
-      return arr.map(function (item) {
-        if (!isObject(item)) {
-          return item;
-        }
-        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
-        /** @type {Array.<string>} */
-        var delKeys = [];
-
-        // 树形数据子节点
-        // @ts-ignore
-        if (childrenField && Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
-          // @ts-ignore
-          newItem[childrenField] = recusion(newItem[childrenField].slice());
-        }
-
-        // 替换字段名
-        Object.keys(fieldNames).forEach(function (newKey) {
-          var oldKey = fieldNames[newKey];
-          if (oldKey in newItem) {
-            // @ts-ignore
-            newItem[newKey] = newItem[oldKey];
-            // @ts-ignore
-            delKeys.push(oldKey);
-          }
-        });
-
-        // 删除旧字段
-        if (delKeys.length > 0) {
-          delKeys.forEach(function (delKey) {
-            // @ts-ignore
-            delete newItem[delKey];
-          });
-        }
-        return newItem;
-      });
+    var num1 = nums[0],
+      _nums$ = nums[1],
+      num2 = _nums$ === void 0 ? 1 : _nums$,
+      rest = nums.slice(2);
+    if (rest.length > 0) {
+      return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
     }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
 
+    // 兼容处理，如果参数包含无效数值时，返回 NaN
     // @ts-ignore
-    return recusion(data.slice());
+    if (isNaN(num1) || isNaN(num2)) {
+      return Number.NaN;
+    }
+    var num1Changed = float2Fixed(num1);
+    var num2Changed = float2Fixed(num2);
+    var baseNum = digitLength(num1) + digitLength(num2);
+    var leftValue = num1Changed * num2Changed;
+    checkBoundary(leftValue);
+    return leftValue / Math.pow(10, baseNum);
   }
 
   /**
-   * 递归处理空子级
+   * 精确加法，支持多个数相加，加数默认为 0 。
+   *
+   * @static
+   * @alias module:Math.plus
+   * @since 3.1.0
+   * @param {...number|string} nums 相加的数
+   * @returns {number} 总和
+   * @example
+   *
+   * plus(0.1, 0.2); // 0.3
+   * plus(0.1, 0.2, 0.3); // 0.6
+   * plus(0.1, 0.2, 0.3, 0.4); // 1
    * 
-   * @private
-   * @template {Record<string,any>} [T=Record<string,any>]
-   * @param {T[]} arr 列表数据
-   * @param {object} [options] 配置项
-   * @param {string} [options.childrenField='children'] 子级字段名称
-   * @param {'none'|'null'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
    */
-  function processEmptyChildren(arr, options) {
-    var _ref = options || {},
-      _ref$childrenField = _ref.childrenField,
-      childrenField = _ref$childrenField === void 0 ? 'children' : _ref$childrenField,
-      _ref$emptyChildrenVal = _ref.emptyChildrenValue,
-      emptyChildrenValue = _ref$emptyChildrenVal === void 0 ? 'none' : _ref$emptyChildrenVal;
-    arr.forEach(function (item) {
-      // if (isObject(item) && Array.isArray(item[childrenField])) {
-      if (item[childrenField].length <= 0) {
-        if (emptyChildrenValue === 'null') {
-          // @ts-ignore
-          item[childrenField] = null;
-          // } else if (emptyChildrenValue === 'none') { // emptyChildrenValue='array' 不会执行该内部方法 
-        } else {
-          delete item[childrenField];
-        }
-      } else {
-        processEmptyChildren(item[childrenField], options);
-      }
-      // }
-    });
+  function plus() {
+    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
+      nums[_key] = arguments[_key];
+    }
+    var num1 = nums[0],
+      _nums$ = nums[1],
+      num2 = _nums$ === void 0 ? 0 : _nums$,
+      rest = nums.slice(2);
+    if (rest.length > 0) {
+      return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
+    }
+    num1 = transformEffectiveNumber(num1);
+    num2 = transformEffectiveNumber(num2);
+
+    // 兼容处理，如果参数包含无效数值时，返回 NaN
+    // @ts-ignore
+    if (isNaN(num1) || isNaN(num2)) {
+      return Number.NaN;
+    }
+    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
+    return (times(num1, baseNum) + times(num2, baseNum)) / baseNum;
   }
 
   /**
-   * 列表数据转树结构
-   * 
+   * 精确减法，支持多个数相减，减数默认为 0 。
+   *
    * @static
-   * @alias module:Processor.listToTree
-   * @since 4.14.0
-   * @template {Record<string,any>} [T=Record<string,any>]
-   * @template {*} [R=T&Record<string,any>]
-   * @param {T[]} list 列表数据
-   * @param {object} [options] 配置项
-   * @param {string} [options.keyField='id'] 当前数据的键值字段名称
-   * @param {string} [options.parentField='pid'] 当前数据的父级字段名称
-   * @param {string} [options.childrenField='children'] 子级字段名称
-   * @param {'none'|'null'|'array'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
-   * @param {'spread'|'self'} [options.nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {R[]} 树结构
-   * @example
-   * 
-   * const menus = [
-   *   { id: '1', name: '首页', code: 'trade', pid: null },
-   *   { id: '2', name: '交易管理', code: 'trade', pid: null },
-   *   { id: '3', name: '交易查询', code: 'trade-1', pid: '2' },
-   *   { id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' },
-   *   { id: '5', name: '权限管理', code: 'authorization', pid: null },
-   *   { id: '6', name: '角色管理', code: 'authorization-1', pid: '5' },
-   *   { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }
-   * ];
-   * listToTree(menus); 
-   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","children":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
-   * 
-   * // 自定义子级字段名
-   * listToTree(basicMenus, { childrenField: 'childs' });
-   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"childs":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","childs":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"childs":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
-   * 
-   */
-  function listToTree(list, options) {
-    var _ref2 = options || {},
-      _ref2$keyField = _ref2.keyField,
-      keyField = _ref2$keyField === void 0 ? 'id' : _ref2$keyField,
-      _ref2$parentField = _ref2.parentField,
-      parentField = _ref2$parentField === void 0 ? 'pid' : _ref2$parentField,
-      _ref2$childrenField = _ref2.childrenField,
-      childrenField = _ref2$childrenField === void 0 ? 'children' : _ref2$childrenField,
-      _ref2$emptyChildrenVa = _ref2.emptyChildrenValue,
-      emptyChildrenValue = _ref2$emptyChildrenVa === void 0 ? 'none' : _ref2$emptyChildrenVa,
-      _ref2$nodeAssign = _ref2.nodeAssign,
-      nodeAssign = _ref2$nodeAssign === void 0 ? 'spread' : _ref2$nodeAssign;
-
-    /** @type {R[]} */
-    var tree = [];
-
-    /** @type {Object.<string, T[]>} */
-    var record = {};
-    if (!Array.isArray(list)) {
-      return tree;
-    }
-    list.forEach(function (item) {
-      if (isObject(item)) {
-        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
-
-        /** @type {string} */
-        var id = newItem[keyField];
-
-        /** @type {string} */
-        var pid = newItem[parentField];
-        if (record[id]) {
-          // @ts-ignore
-          newItem[childrenField] = record[id];
-        } else {
-          // @ts-ignore
-          newItem[childrenField] = record[id] = [];
-        }
-        if (pid) {
-          if (!record[pid]) {
-            record[pid] = [newItem];
-          } else {
-            record[pid].push(newItem);
-          }
-        } else {
-          // @ts-ignore
-          tree.push(newItem);
-        }
-      }
-    });
-    if (emptyChildrenValue !== 'array') {
-      // @ts-ignore
-      processEmptyChildren(tree, options);
-    }
-    return tree;
-  }
-
-  /**
-   * 树结构转列表数据
-   * 
-   * @static
-   * @alias module:Processor.treeToList
-   * @since 4.14.0
-   * @template {Record<string,any>} T
-   * @template {keyof T} K
-   * @template {Omit<T, K>} R
-   * @param {T[]} tree 列表数据
-   * @param {K} childrenField 子级字段名称
-   * @returns {R[]} 列表数据
-   * @example
-   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
-   * 
-   * treeToList(menus, 'children'));
-   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null},{"id":"3","name":"交易查询","code":"trade-1","pid":"2"},{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"},{"id":"5","name":"权限管理","code":"authorization","pid":null},{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]
-   */
-  function treeToList(tree, childrenField) {
-    /** @type {R[]} */
-    var list = [];
-    if (!Array.isArray(tree)) {
-      return list;
-    }
-
-    /**
-     * 递归遍历
-     * @param {T[]} arr 列表数据
-     */
-    function recusion(arr) {
-      arr.forEach(function (item) {
-        if (isObject(item)) {
-          var newItem = _objectSpread2({}, item);
-          // @ts-ignore
-          list.push(newItem);
-          if (newItem[childrenField]) {
-            if (Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
-              recusion(newItem[childrenField]);
-            }
-            delete newItem[childrenField];
-          }
-        } else {
-          // @ts-ignore
-          list.push(item);
-        }
-      });
-    }
-    recusion(tree);
-    return list;
-  }
-
-  /**
-   * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
-   * 
-   * @static
-   * @alias module:Processor.filterTree
-   * @since 4.15.0
-   * @template {any} T
-   * @template {(item: T) => boolean} F
-   * @param {T[]} tree 树结构数据
-   * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，结果将包含该节点
-   * @param {string} [childrenField='children'] 子级字段名
-   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {T[]}
-   * @example
-   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
-   * 
-   * filterTree(menus, item=>item.name.indexOf('管理') > -1);
-   * // [{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
-   * 
-   * // 如果某节点被过滤掉，它的子节点也一并抛弃
-   * filterTree(menus, item=>item.id === '7');
-   * // []
-   * 
-   * filterTree(menus, item=>item.id === 'not found');
-   * // []
-   */
-  function filterTree(tree, predicate) {
-    var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
-    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
-    /** @type {T[]} */
-    var result = [];
-    if (!Array.isArray(tree)) {
-      return result;
-    }
-    tree.forEach(function (item) {
-      var newItem = item;
-      if (isObject(item)) {
-        // @ts-ignore
-        newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
-      }
-      if (predicate(newItem)) {
-        if (isObject(newItem)) {
-          /** @type {T[]|undefined} */
-          // @ts-ignore
-          var childs = newItem[childrenField];
-          if (Array.isArray(childs) && childs.length > 0) {
-            // @ts-ignore
-            newItem[childrenField] = filterTree(childs, predicate, childrenField, nodeAssign);
-          }
-        }
-        result.push(newItem);
-      }
-    });
-    return result;
-  }
-
-  /**
-   * 精确乘法，支持多个数相乘，乘数默认为 1 。
-   *
-   * @static
-   * @alias module:Math.times
+   * @alias module:Math.minus
    * @since 3.1.0
-   * @param {...number|string} nums 相乘的数
-   * @returns {number} 乘积
+   * @param {...number|string} nums 相减的数
+   * @returns {number} 差
    * @example
    *
-   * times(3, 0.6); // 1.8
-   * times(3, 0.6, 2); // 3.6
-   * times(3, 0.6, 2, 10); // 36
+   * minus(1, 0.9); // 0.1
+   * minus(1, 0.9, 0.02); // 0.08
+   * minus(1, 0.9, 0.02, 0.08); // 0
    * 
    */
-  function times() {
+  function minus() {
     for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
       nums[_key] = arguments[_key];
     }
     var num1 = nums[0],
       _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 1 : _nums$,
+      num2 = _nums$ === void 0 ? 0 : _nums$,
       rest = nums.slice(2);
     if (rest.length > 0) {
-      return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
+      return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
     }
     num1 = transformEffectiveNumber(num1);
     num2 = transformEffectiveNumber(num2);
@@ -3053,39 +2920,40 @@
     if (isNaN(num1) || isNaN(num2)) {
       return Number.NaN;
     }
-    var num1Changed = float2Fixed(num1);
-    var num2Changed = float2Fixed(num2);
-    var baseNum = digitLength(num1) + digitLength(num2);
-    var leftValue = num1Changed * num2Changed;
-    checkBoundary(leftValue);
-    return leftValue / Math.pow(10, baseNum);
+    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
+    return (times(num1, baseNum) - times(num2, baseNum)) / baseNum;
   }
 
   /**
-   * 精确加法，支持多个数相加，加数默认为 0 。
+   * 精确除法，支持多个数相除，除数默认为 1 。
    *
    * @static
-   * @alias module:Math.plus
+   * @alias module:Math.divide
    * @since 3.1.0
-   * @param {...number|string} nums 相加的数
-   * @returns {number} 总和
+   * @param {...number|string} nums 被除数和除数
+   * @returns {number} 商数
    * @example
    *
-   * plus(0.1, 0.2); // 0.3
-   * plus(0.1, 0.2, 0.3); // 0.6
-   * plus(0.1, 0.2, 0.3, 0.4); // 1
+   * divide(1.21); // 1.21 除数默认为 1 ，即 1.21/1 = 1.21
+   * divide(1.21, 1.1); // 1.1
+   * divide(1000, 10, 10); // 10
+   * divide(1000, 10, 10, 10); // 1
+   * 
+   * divide(); // NaN  如果没有传入参数，被除数默认为 undefined 。 Number(undefined) 转换为 NaN ，NaN/1 = NaN
+   * divide(null); // 0  Number(null) 转换为 0 ， 0/1 = 0
+   * divide('1.5 ', 0.5); // 3  Number('1.5 ') 转换为 1.5 ，1.5/0.5 = 3
    * 
    */
-  function plus() {
+  function divide() {
     for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
       nums[_key] = arguments[_key];
     }
     var num1 = nums[0],
       _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 0 : _nums$,
+      num2 = _nums$ === void 0 ? 1 : _nums$,
       rest = nums.slice(2);
     if (rest.length > 0) {
-      return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
+      return divide.apply(void 0, [divide(num1, num2)].concat(_toConsumableArray(rest)));
     }
     num1 = transformEffectiveNumber(num1);
     num2 = transformEffectiveNumber(num2);
@@ -3095,100 +2963,19 @@
     if (isNaN(num1) || isNaN(num2)) {
       return Number.NaN;
     }
-    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
-    return (times(num1, baseNum) + times(num2, baseNum)) / baseNum;
+    var num1Changed = float2Fixed(num1);
+    var num2Changed = float2Fixed(num2);
+    checkBoundary(num1Changed);
+    checkBoundary(num2Changed);
+    // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
+    return times(num1Changed / num2Changed, strip(Math.pow(10, digitLength(num2) - digitLength(num1))));
   }
 
   /**
-   * 精确减法，支持多个数相减，减数默认为 0 。
+   * 四舍五入，支持设置精度
    *
    * @static
-   * @alias module:Math.minus
-   * @since 3.1.0
-   * @param {...number|string} nums 相减的数
-   * @returns {number} 差
-   * @example
-   *
-   * minus(1, 0.9); // 0.1
-   * minus(1, 0.9, 0.02); // 0.08
-   * minus(1, 0.9, 0.02, 0.08); // 0
-   * 
-   */
-  function minus() {
-    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
-      nums[_key] = arguments[_key];
-    }
-    var num1 = nums[0],
-      _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 0 : _nums$,
-      rest = nums.slice(2);
-    if (rest.length > 0) {
-      return minus.apply(void 0, [minus(num1, num2)].concat(_toConsumableArray(rest)));
-    }
-    num1 = transformEffectiveNumber(num1);
-    num2 = transformEffectiveNumber(num2);
-
-    // 兼容处理，如果参数包含无效数值时，返回 NaN
-    // @ts-ignore
-    if (isNaN(num1) || isNaN(num2)) {
-      return Number.NaN;
-    }
-    var baseNum = Math.pow(10, Math.max(digitLength(num1), digitLength(num2)));
-    return (times(num1, baseNum) - times(num2, baseNum)) / baseNum;
-  }
-
-  /**
-   * 精确除法，支持多个数相除，除数默认为 1 。
-   *
-   * @static
-   * @alias module:Math.divide
-   * @since 3.1.0
-   * @param {...number|string} nums 被除数和除数
-   * @returns {number} 商数
-   * @example
-   *
-   * divide(1.21); // 1.21 除数默认为 1 ，即 1.21/1 = 1.21
-   * divide(1.21, 1.1); // 1.1
-   * divide(1000, 10, 10); // 10
-   * divide(1000, 10, 10, 10); // 1
-   * 
-   * divide(); // NaN  如果没有传入参数，被除数默认为 undefined 。 Number(undefined) 转换为 NaN ，NaN/1 = NaN
-   * divide(null); // 0  Number(null) 转换为 0 ， 0/1 = 0
-   * divide('1.5 ', 0.5); // 3  Number('1.5 ') 转换为 1.5 ，1.5/0.5 = 3
-   * 
-   */
-  function divide() {
-    for (var _len = arguments.length, nums = new Array(_len), _key = 0; _key < _len; _key++) {
-      nums[_key] = arguments[_key];
-    }
-    var num1 = nums[0],
-      _nums$ = nums[1],
-      num2 = _nums$ === void 0 ? 1 : _nums$,
-      rest = nums.slice(2);
-    if (rest.length > 0) {
-      return divide.apply(void 0, [divide(num1, num2)].concat(_toConsumableArray(rest)));
-    }
-    num1 = transformEffectiveNumber(num1);
-    num2 = transformEffectiveNumber(num2);
-
-    // 兼容处理，如果参数包含无效数值时，返回 NaN
-    // @ts-ignore
-    if (isNaN(num1) || isNaN(num2)) {
-      return Number.NaN;
-    }
-    var num1Changed = float2Fixed(num1);
-    var num2Changed = float2Fixed(num2);
-    checkBoundary(num1Changed);
-    checkBoundary(num2Changed);
-    // fix: 类似 10 ** -4 为 0.00009999999999999999，strip 修正
-    return times(num1Changed / num2Changed, strip(Math.pow(10, digitLength(num2) - digitLength(num1))));
-  }
-
-  /**
-   * 四舍五入，支持设置精度
-   *
-   * @static
-   * @alias module:Math.round
+   * @alias module:Math.round
    * @since 3.1.0
    * @param {number|string} num 要四舍五入的数字
    * @param {number} [precision=0] 四舍五入的精度
@@ -3214,29 +3001,150 @@
   }
 
   /**
-   * 等待时间返回 Promise 。常用于异步方法中延时。
-   *
+   * @typedef {XMLHttpRequest['onloadstart']} XMLHttpRequestEvent XMLHttpRequest 事件对象
+   */
+
+  /**
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
+   * @typedef {Object} AjaxOptions ajax配置项
+   * @property {string} [method="get"] 创建请求时使用的方法
+   * @property {Document | XMLHttpRequestBodyInit | null} [data=null] 请求体被发送的数据
+   * @property {Object.<string, string>} [headers] 自定义请求头
+   * @property {XMLHttpRequestResponseType} [responseType] 响应类型
+   * @property {number} [timeout] 请求超时的毫秒数
+   * @property {boolean} [withCredentials=false] 跨域请求时是否需要使用凭证
+   * @property {boolean} [async=true] 是否异步执行操作
+   * @property {string|null} [user=null] 用户名，用于认证用途
+   * @property {string|null} [password=null] 密码，用于认证用途
+   * @property {XMLHttpRequestEvent} [onLoadStart] 接收到响应数据时触发
+   * @property {XMLHttpRequestEvent} [onProgress] 请求接收到更多数据时，周期性地触发
+   * @property {XMLHttpRequestEvent} [onAbort] 当 request 被停止时触发，例如当程序调用 XMLHttpRequest.abort() 时
+   * @property {XMLHttpRequestEvent} [onTimeout] 在预设时间内没有接收到响应时触发
+   * @property {XMLHttpRequestEvent} [onError] 当 request 遭遇错误时触发
+   * @property {XMLHttpRequestEvent} [onLoad] 请求成功完成时触发
+   * @property {XMLHttpRequestEvent} [onLoadEnd] 请求结束时触发，无论请求成功 (load) 还是失败 (abort 或 error)
+   */
+
+  /**
+   * 请求<br/><br/>
+   * 
+   * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+   * 
    * @static
-   * @alias module:Other.waitTime
-   * @since 4.2.0
-   * @param {number} [time=1000] 延时时间，单位毫秒
-   * @returns {Promise<void>}
+   * @alias module:Other.ajax
+   * @since 4.16.0
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest|XMLHttpRequest}
+   * @param {string} url 地址
+   * @param {AjaxOptions} [options] 配置项
+   * @returns {Promise<ProgressEvent<EventTarget>>}
    * @example
-   * 
-   * const test = async ()=>{
-   *   await waitTime();
-   *   // do something
-   * }
-   *
-   * waitTime(500).then(()=>{
+   * ajax('/somefile').then(res=>{
    *   // do something
    * });
    * 
+   * ajax('/api', { method: 'post' }).then(res=>{
+   *   // do something
+   * });
    */
-  function waitTime() {
-    var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
-    return new Promise(function (resolve) {
-      setTimeout(resolve, time);
+  function ajax(url, options) {
+    var _ref = options || {},
+      _ref$method = _ref.method,
+      method = _ref$method === void 0 ? 'get' : _ref$method,
+      _ref$data = _ref.data,
+      data = _ref$data === void 0 ? null : _ref$data,
+      timeout = _ref.timeout,
+      headers = _ref.headers,
+      _ref$withCredentials = _ref.withCredentials,
+      withCredentials = _ref$withCredentials === void 0 ? false : _ref$withCredentials,
+      _ref$async = _ref.async,
+      async = _ref$async === void 0 ? true : _ref$async,
+      _ref$user = _ref.user,
+      user = _ref$user === void 0 ? null : _ref$user,
+      _ref$password = _ref.password,
+      password = _ref$password === void 0 ? null : _ref$password,
+      responseType = _ref.responseType,
+      onAbort = _ref.onAbort,
+      onError = _ref.onError,
+      onLoad = _ref.onLoad,
+      onLoadEnd = _ref.onLoadEnd,
+      onLoadStart = _ref.onLoadStart,
+      onProgress = _ref.onProgress,
+      onTimeout = _ref.onTimeout;
+    return new Promise(function (resolve, reject) {
+      var xhr = new XMLHttpRequest();
+      xhr.open(method.toLowerCase(), url, async, user, password);
+
+      // 设置请求超时
+      if (typeof timeout === 'number' && timeout > 0) {
+        xhr.timeout = timeout;
+      }
+
+      // 跨域请求时是否需要使用凭证
+      xhr.withCredentials = withCredentials;
+
+      // 设置响应类型
+      if (responseType) {
+        xhr.responseType = responseType;
+      }
+
+      // 设置请求头
+      if (_typeof(headers) === 'object') {
+        Object.keys(headers).map(function (item) {
+          xhr.setRequestHeader(item, headers[item]);
+        });
+      }
+
+      /**
+       * 请求成功异步调用
+       * @param {XMLHttpRequestEvent} [cb] 回调方法
+       */
+      var wrapSuccess = function wrapSuccess(cb) {
+        /**
+         * 内部方法
+         * @param {ProgressEvent<EventTarget>} e 事件对象
+         */
+        return function (e) {
+          resolve(e);
+          cb === null || cb === void 0 ? void 0 : cb.call(xhr, e);
+        };
+      };
+
+      /**
+       * 请求失败（中断/超时/失败）处理
+         * @param {XMLHttpRequestEvent} [cb] 回调方法
+       */
+      var wrapError = function wrapError(cb) {
+        /**
+         * 内部方法
+         * @param {ProgressEvent<EventTarget>} e 事件对象
+         */
+        return function (e) {
+          reject(e);
+          cb === null || cb === void 0 ? void 0 : cb.call(xhr, e);
+        };
+      };
+
+      // 事件处理
+      /**@type {Object.<keyof XMLHttpRequestEventTargetEventMap, XMLHttpRequestEvent | undefined>} */
+      var events = {
+        loadstart: onLoadStart,
+        progress: onProgress,
+        abort: wrapError(onAbort),
+        timeout: wrapError(onTimeout),
+        error: wrapError(onError),
+        load: wrapSuccess(onLoad),
+        loadend: onLoadEnd
+      };
+      /**@type {(keyof XMLHttpRequestEventTargetEventMap)[]} */
+      // @ts-ignore
+      var eventNames = Object.keys(events);
+      eventNames.map(function (item) {
+        var func = events[item];
+        if (func) {
+          xhr.addEventListener(item, func);
+        }
+      });
+      xhr.send(data);
     });
   }
 
@@ -3293,6 +3201,154 @@
     return pos;
   }
 
+  /**
+   * 下载文件
+   * 
+   * @param {string} blobUrl blob 地址
+   * @param {string} [fileName] 文件名称
+   */
+  function saver(blobUrl, fileName) {
+    var anchor = document.createElement('a');
+    // anchor.href = decodeURIComponent(blobUrl);
+    anchor.href = blobUrl;
+    anchor.style.display = 'none';
+    anchor.setAttribute('download', fileName || '');
+
+    /**
+     * 处理点击事件，防止事件冒泡到 body/html 的点击事件。
+     * 
+     * @param {MouseEvent} e 鼠标事件对象
+     */
+    function handleClick(e) {
+      e.stopPropagation();
+      anchor.removeEventListener('click', handleClick);
+    }
+    anchor.addEventListener('click', handleClick);
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
+  }
+
+  /**
+   * @typedef {import('./ajax.js').AjaxOptions} AjaxOptions ajax 配置项
+   */
+
+  /**
+   * @callback TransformRequest
+   * @param {AjaxOptions} options ajax 配置项
+   * @returns {AjaxOptions}
+   */
+
+  /**
+   * @callback TransformResponse
+   * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
+   * @returns {Blob}
+   */
+
+  /**
+   * @typedef {Object} DownloadOptions 下载配置项
+   * @property {string} [options.fileName] 文件名称
+   * @property {string} [options.type] MIME 类型
+   * @property {'url'|'text'} [options.dataType] 手动设置数据类型，默认会根据传入的数据判断类型，主要是为了区分 url 和 text 。<br/>如果你要下载的文本是 url ，请设置 'text' ；如果你要下载的 url 是绝对/相对路径，请设置 'url' 。
+   * @property {TransformRequest} [options.transformRequest] 请求前触发，XHR 对象或配置调整
+   * @property {TransformResponse} [options.transformResponse] 请求成功后触发，在传递给 then/catch 前，允许修改响应数据
+   */
+
+  /**
+   * 下载<br/><br/>
+   * 
+   * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端，兼容 IE10+ 和现代浏览器。</em>
+   * 
+   * @static
+   * @alias module:Other.download
+   * @since 4.16.0
+   * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展|多用途互联网邮件扩展}
+   * @param {string|Blob|ArrayBuffer|Int8Array|Uint8Array|Uint8ClampedArray|Int16Array|Uint16Array|Int32Array|Uint32Array|Float32Array|Float64Array|BigInt64Array|BigUint64Array} data 字符串、blob数据或url地址
+   * @param {string|DownloadOptions} [options] 文件名称 或 配置项
+   * @returns {Promise<void>}
+   * @example
+   * // 文本
+   * download('hello world', 'text.txt');
+   * 
+   * // 远程文件
+   * download('/xxx.jpg', { dataType: 'url' });
+   * 
+   * // blob文件
+   * download(new Blob(['hello world']), 'text.txt');
+   * 
+   */
+  function download(data, options) {
+    var config = _typeof(options) === 'object' ? options : {};
+    if (typeof options === 'string') {
+      config.fileName = options;
+    }
+    var fileName = config.fileName,
+      type = config.type,
+      dataType = config.dataType,
+      transformRequest = config.transformRequest,
+      transformResponse = config.transformResponse;
+
+    /** @type {Blob|undefined} */
+    var payload;
+
+    // dataURLs、blob url、url、string
+    if (typeof data === 'string') {
+      if (!dataType && /^blob:.*?\/.*/.test(data)) {
+        // blob url
+        saver(data, fileName);
+        return Promise.resolve();
+      } else if (!dataType && /^data:([\w+-]+\/[\w+.-]+)?[,;]/.test(data)) {
+        // dataURLs
+        payload = dataURLToBlob(data);
+      } else if (dataType === 'url' || !dataType && isUrl(data)) {
+        // url
+        /** @type {AjaxOptions} */
+        var defaultAjaxOptions = {
+          responseType: 'blob'
+        };
+        // 请求前配置调整
+        var ajaxOptions = typeof transformRequest === 'function' ? transformRequest(defaultAjaxOptions) : defaultAjaxOptions;
+        return ajax(data, ajaxOptions).then(function (e) {
+          /** @type {Blob} */
+          // @ts-ignore
+          // 响应结果调整
+          var res = typeof transformResponse === 'function' ? transformResponse(e.target.response) : e.target.response;
+          var currentFileName = fileName || data.split("?")[0].split("#")[0].split("/").pop();
+          return download(res, {
+            fileName: currentFileName,
+            type: type || (isBlob(res) ? res.type : undefined)
+          });
+        });
+      } else {
+        // string
+        payload = new Blob([data], {
+          type: type || 'text/plain'
+        });
+      }
+    } else if (isBlob(data)) {
+      // @ts-ignore
+      payload = data;
+    }
+
+    // html、TypedArray
+    if (!(payload instanceof Blob)) {
+      payload = new Blob([data], {
+        type: type
+      });
+    }
+
+    // @ts-ignore
+    if (navigator.msSaveBlob) {
+      // @ts-ignore
+      navigator.msSaveBlob(payload, fileName || 'download');
+    } else {
+      var url = URL.createObjectURL(payload);
+      saver(url, fileName);
+      URL.revokeObjectURL(url);
+    }
+    return Promise.resolve();
+  }
+
   var numberChars = '0123456789';
   var letterChars = 'abcdefghijklmnopqrstuvwxyz';
   var defaultChars = numberChars + letterChars + letterChars.toUpperCase();
@@ -3371,11 +3427,360 @@
     return len;
   }
 
+  /**
+   * 等待时间返回 Promise 。常用于异步方法中延时。
+   *
+   * @static
+   * @alias module:Other.waitTime
+   * @since 4.2.0
+   * @param {number} [time=1000] 延时时间，单位毫秒
+   * @returns {Promise<void>}
+   * @example
+   * 
+   * const test = async ()=>{
+   *   await waitTime();
+   *   // do something
+   * }
+   *
+   * waitTime(500).then(()=>{
+   *   // do something
+   * });
+   * 
+   */
+  function waitTime() {
+    var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
+    return new Promise(function (resolve) {
+      setTimeout(resolve, time);
+    });
+  }
+
+  /**
+   * 转换字段名，返回一个转换字段后的值，不改变原值。
+   * 
+   * @static
+   * @alias module:Processor.transformFieldNames
+   * @since 4.14.0
+   * @template {*} D
+   * @template {Record<string, keyof D>} F
+   * @template {string} C
+   * @param {D[]} data 对象数组。如果是树结构数据，需要指定第三个参数 childrenField
+   * @param {F} fieldNames 字段名映射
+   * @param {C} [childrenField] 子级数据字段名
+   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+   * @returns {import('./interface.type.js').TransformFieldNames<D, F, C>}
+   * @example
+   * 
+   * const options = [{code: '1', name: 'one'},{code:'2', name:'two'}];
+   * const newOptions = transformFieldNames(options, {label: 'name', value: 'code'});
+   * // [{value: '1', label: 'one'},{value:'2', label:'two'}]
+   * 
+   * // 嵌套数据，指定子级字段名 children
+   * const options2 = [{code: '1', name: 'one'},{code:'2', name:'two', children: [{code:'2-1', name:'two-one', children: [{code: '2-1-1', name:'two-one-one'}]}]}];
+   * const newOptions2 = transformFieldNames(options2, {label: 'name', value: 'code'}, 'children');
+   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one', children: [{value: '2-1-1', label:'two-one-one'}]}]}]
+   * 
+   * const options3 = [{code: '1', name: 'one'},{code:'2', name:'two', childs: [{code:'2-1', name:'two-one'}]}];
+   * const newOptions3 = transformFieldNames(options3, {label: 'name', value: 'code'}, 'childs');
+   * // [{value: '1', label: 'one'},{value:'2', label:'two', childs: [{value: '2-1', label:'two-one'}]}]
+   * 
+   * // 嵌套数据，并替换子集字段名
+   * const newOptions4 = transformFieldNames(options3, {label: 'name', value: 'code', children: 'childs'}, 'childs');
+   * // [{value: '1', label: 'one'},{value:'2', label:'two', children: [{value: '2-1', label:'two-one'}]}]
+   */
+  function transformFieldNames(data, fieldNames, childrenField) {
+    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
+    if (!Array.isArray(data)) {
+      return data;
+    }
+    if (data.length <= 0) {
+      // @ts-ignore
+      return [];
+    }
+
+    /**
+     * 递归处理字段名
+     * 
+     * @param {Array.<object>} arr 列表数据
+     * @returns {*}
+     */
+    function recusion(arr) {
+      return arr.map(function (item) {
+        if (!isObject(item)) {
+          return item;
+        }
+        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
+        /** @type {Array.<string>} */
+        var delKeys = [];
+
+        // 树形数据子节点
+        // @ts-ignore
+        if (childrenField && Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
+          // @ts-ignore
+          newItem[childrenField] = recusion(newItem[childrenField].slice());
+        }
+
+        // 替换字段名
+        Object.keys(fieldNames).forEach(function (newKey) {
+          var oldKey = fieldNames[newKey];
+          if (oldKey in newItem) {
+            // @ts-ignore
+            newItem[newKey] = newItem[oldKey];
+            // @ts-ignore
+            delKeys.push(oldKey);
+          }
+        });
+
+        // 删除旧字段
+        if (delKeys.length > 0) {
+          delKeys.forEach(function (delKey) {
+            // @ts-ignore
+            delete newItem[delKey];
+          });
+        }
+        return newItem;
+      });
+    }
+
+    // @ts-ignore
+    return recusion(data.slice());
+  }
+
+  /**
+   * 递归处理空子级
+   * 
+   * @private
+   * @template {Record<string,any>} [T=Record<string,any>]
+   * @param {T[]} arr 列表数据
+   * @param {object} [options] 配置项
+   * @param {string} [options.childrenField='children'] 子级字段名称
+   * @param {'none'|'null'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
+   */
+  function processEmptyChildren(arr, options) {
+    var _ref = options || {},
+      _ref$childrenField = _ref.childrenField,
+      childrenField = _ref$childrenField === void 0 ? 'children' : _ref$childrenField,
+      _ref$emptyChildrenVal = _ref.emptyChildrenValue,
+      emptyChildrenValue = _ref$emptyChildrenVal === void 0 ? 'none' : _ref$emptyChildrenVal;
+    arr.forEach(function (item) {
+      // if (isObject(item) && Array.isArray(item[childrenField])) {
+      if (item[childrenField].length <= 0) {
+        if (emptyChildrenValue === 'null') {
+          // @ts-ignore
+          item[childrenField] = null;
+          // } else if (emptyChildrenValue === 'none') { // emptyChildrenValue='array' 不会执行该内部方法 
+        } else {
+          delete item[childrenField];
+        }
+      } else {
+        processEmptyChildren(item[childrenField], options);
+      }
+      // }
+    });
+  }
+
+  /**
+   * 列表数据转树结构
+   * 
+   * @static
+   * @alias module:Tree.listToTree
+   * @since 4.14.0
+   * @template {Record<string,any>} [T=Record<string,any>]
+   * @template {*} [R=T&Record<string,any>]
+   * @param {T[]} list 列表数据
+   * @param {object} [options] 配置项
+   * @param {string} [options.keyField='id'] 当前数据的键值字段名称
+   * @param {string} [options.parentField='pid'] 当前数据的父级字段名称
+   * @param {string} [options.childrenField='children'] 子级字段名称
+   * @param {'none'|'null'|'array'} [options.emptyChildrenValue='none'] 子级为空时的值，none表示删除该子级，null表示为null，array表示为[]。
+   * @param {'spread'|'self'} [options.nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+   * @returns {R[]} 树结构
+   * @example
+   * 
+   * const menus = [
+   *   { id: '1', name: '首页', code: 'trade', pid: null },
+   *   { id: '2', name: '交易管理', code: 'trade', pid: null },
+   *   { id: '3', name: '交易查询', code: 'trade-1', pid: '2' },
+   *   { id: '4', name: '交易查询-查询操作', code: 'trade-1-1', pid: '3' },
+   *   { id: '5', name: '权限管理', code: 'authorization', pid: null },
+   *   { id: '6', name: '角色管理', code: 'authorization-1', pid: '5' },
+   *   { id: '7', name: '用户管理', code: 'authorization-2', pid: '5' }
+   * ];
+   * listToTree(menus); 
+   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","children":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * 
+   * // 自定义子级字段名
+   * listToTree(basicMenus, { childrenField: 'childs' });
+   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null,"childs":[{"id":"3","name":"交易查询","code":"trade-1","pid":"2","childs":[{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"}]}]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"childs":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * 
+   */
+  function listToTree(list, options) {
+    var _ref2 = options || {},
+      _ref2$keyField = _ref2.keyField,
+      keyField = _ref2$keyField === void 0 ? 'id' : _ref2$keyField,
+      _ref2$parentField = _ref2.parentField,
+      parentField = _ref2$parentField === void 0 ? 'pid' : _ref2$parentField,
+      _ref2$childrenField = _ref2.childrenField,
+      childrenField = _ref2$childrenField === void 0 ? 'children' : _ref2$childrenField,
+      _ref2$emptyChildrenVa = _ref2.emptyChildrenValue,
+      emptyChildrenValue = _ref2$emptyChildrenVa === void 0 ? 'none' : _ref2$emptyChildrenVa,
+      _ref2$nodeAssign = _ref2.nodeAssign,
+      nodeAssign = _ref2$nodeAssign === void 0 ? 'spread' : _ref2$nodeAssign;
+
+    /** @type {R[]} */
+    var tree = [];
+
+    /** @type {Object.<string, T[]>} */
+    var record = {};
+    if (!Array.isArray(list)) {
+      return tree;
+    }
+    list.forEach(function (item) {
+      if (isObject(item)) {
+        var newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
+
+        /** @type {string} */
+        var id = newItem[keyField];
+
+        /** @type {string} */
+        var pid = newItem[parentField];
+        if (record[id]) {
+          // @ts-ignore
+          newItem[childrenField] = record[id];
+        } else {
+          // @ts-ignore
+          newItem[childrenField] = record[id] = [];
+        }
+        if (pid) {
+          if (!record[pid]) {
+            record[pid] = [newItem];
+          } else {
+            record[pid].push(newItem);
+          }
+        } else {
+          // @ts-ignore
+          tree.push(newItem);
+        }
+      }
+    });
+    if (emptyChildrenValue !== 'array') {
+      // @ts-ignore
+      processEmptyChildren(tree, options);
+    }
+    return tree;
+  }
+
+  /**
+   * 树结构转列表数据
+   * 
+   * @static
+   * @alias module:Tree.treeToList
+   * @since 4.14.0
+   * @template {Record<string,any>} T
+   * @template {keyof T} K
+   * @template {Omit<T, K>} R
+   * @param {T[]} tree 列表数据
+   * @param {K} childrenField 子级字段名称
+   * @returns {R[]} 列表数据
+   * @example
+   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
+   * 
+   * treeToList(menus, 'children'));
+   * // [{"id":"1","name":"首页","code":"trade","pid":null},{"id":"2","name":"交易管理","code":"trade","pid":null},{"id":"3","name":"交易查询","code":"trade-1","pid":"2"},{"id":"4","name":"交易查询-查询操作","code":"trade-1-1","pid":"3"},{"id":"5","name":"权限管理","code":"authorization","pid":null},{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]
+   */
+  function treeToList(tree, childrenField) {
+    /** @type {R[]} */
+    var list = [];
+    if (!Array.isArray(tree)) {
+      return list;
+    }
+
+    /**
+     * 递归遍历
+     * @param {T[]} arr 列表数据
+     */
+    function recusion(arr) {
+      arr.forEach(function (item) {
+        if (isObject(item)) {
+          var newItem = _objectSpread2({}, item);
+          // @ts-ignore
+          list.push(newItem);
+          if (newItem[childrenField]) {
+            if (Array.isArray(newItem[childrenField]) && newItem[childrenField].length > 0) {
+              recusion(newItem[childrenField]);
+            }
+            delete newItem[childrenField];
+          }
+        } else {
+          // @ts-ignore
+          list.push(item);
+        }
+      });
+    }
+    recusion(tree);
+    return list;
+  }
+
+  /**
+   * 过滤/筛选树节点。<br/><br/>如果某节点被过滤掉，它的子节点也一并抛弃
+   * 
+   * @static
+   * @alias module:Tree.filterTree
+   * @since 4.15.0
+   * @template {any} T
+   * @template {(item: T) => boolean} F
+   * @param {T[]} tree 树结构数据
+   * @param {F} predicate 遍历每一项执行的函数，参数是当前遍历到的节点数据，如果返回 Truthy ，结果将包含该节点
+   * @param {string} [childrenField='children'] 子级字段名
+   * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
+   * @returns {T[]}
+   * @example
+   * const menus = [{ "id": "1", "name": "首页", "code": "trade", "pid": null }, { "id": "2", "name": "交易管理", "code": "trade", "pid": null, "children": [{ "id": "3", "name": "交易查询", "code": "trade-1", "pid": "2", "children": [{ "id": "4", "name": "交易查询-查询操作", "code": "trade-1-1", "pid": "3" }] }] }, { "id": "5", "name": "权限管理", "code": "authorization", "pid": null, "children": [{ "id": "6", "name": "角色管理", "code": "authorization-1", "pid": "5" }, { "id": "7", "name": "用户管理", "code": "authorization-2", "pid": "5" }] }];
+   * 
+   * filterTree(menus, item=>item.name.indexOf('管理') > -1);
+   * // [{"id":"2","name":"交易管理","code":"trade","pid":null,"children":[]},{"id":"5","name":"权限管理","code":"authorization","pid":null,"children":[{"id":"6","name":"角色管理","code":"authorization-1","pid":"5"},{"id":"7","name":"用户管理","code":"authorization-2","pid":"5"}]}]
+   * 
+   * // 如果某节点被过滤掉，它的子节点也一并抛弃
+   * filterTree(menus, item=>item.id === '7');
+   * // []
+   * 
+   * filterTree(menus, item=>item.id === 'not found');
+   * // []
+   */
+  function filterTree(tree, predicate) {
+    var childrenField = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'children';
+    var nodeAssign = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'spread';
+    /** @type {T[]} */
+    var result = [];
+    if (!Array.isArray(tree)) {
+      return result;
+    }
+    tree.forEach(function (item) {
+      var newItem = item;
+      if (isObject(item)) {
+        // @ts-ignore
+        newItem = nodeAssign === 'spread' ? _objectSpread2({}, item) : item;
+      }
+      if (predicate(newItem)) {
+        if (isObject(newItem)) {
+          /** @type {T[]|undefined} */
+          // @ts-ignore
+          var childs = newItem[childrenField];
+          if (Array.isArray(childs) && childs.length > 0) {
+            // @ts-ignore
+            newItem[childrenField] = filterTree(childs, predicate, childrenField, nodeAssign);
+          }
+        }
+        result.push(newItem);
+      }
+    });
+    return result;
+  }
+
   /**
    * 查找树结构数据节点
    * 
    * @static
-   * @alias module:Other.findTreeNode
+   * @alias module:Tree.findTreeNode
    * @since 4.14.0
    * @template {any} T
    * @template {(item: T) => boolean} F
@@ -3443,7 +3848,7 @@
    * 查找树结构数据多个节点
    * 
    * @static
-   * @alias module:Other.findTreeNodes
+   * @alias module:Tree.findTreeNodes
    * @since 4.15.0
    * @template {any} T
    * @template {(item: T) => boolean} F
@@ -3557,7 +3962,7 @@
    * 查找包含当前节点的所有父级节点
    * 
    * @static
-   * @alias module:Other.findTreeSelect
+   * @alias module:Tree.findTreeSelect
    * @since 4.14.0
    * @template {any} T
    * @template {(item: T) => boolean} F
@@ -3582,11 +3987,14 @@
     return internalFindTreeSelect(tree, predicate, childrenField);
   }
 
+  exports.ajax = ajax;
   exports.blobToDataURL = blobToDataURL;
   exports.bytesToSize = bytesToSize;
   exports.calculateCursorPosition = calculateCursorPosition;
   exports.dataURLToBlob = dataURLToBlob;
   exports.divide = divide;
+  exports.download = download;
+  exports.fileReader = fileReader;
   exports.filterTree = filterTree;
   exports.findTreeNode = findTreeNode;
   exports.findTreeNodes = findTreeNodes;