util-helpers 4.15.3 → 4.16.1

package/dist/util-helpers.js

@@ -110,8 +110,8 @@
    *
    * @static
    * @alias module:Processor.normalizeString
-   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
    * @since 4.3.0
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
    * @param {*} value 待处理的值
    * @returns {string} 规整化的值
    * @example
@@ -235,8 +235,8 @@
    * @static
    * @alias module:Validator.isIdCard
    * @since 1.1.0
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/中华人民共和国公民身份号码|中华人民共和国公民身份号码}
-   * @see 参考 {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
+   * @see {@link https://zh.wikipedia.org/wiki/中华人民共和国公民身份号码|中华人民共和国公民身份号码}
+   * @see {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.loose=false] 宽松模式，支持15位身份证号码
@@ -350,8 +350,8 @@
    *
    * @static
    * @alias module:Validator.isVehicle
-   * @see 参考 {@link https://baike.baidu.com/item/车牌号|车牌号}
    * @since 1.1.0
+   * @see {@link https://baike.baidu.com/item/车牌号|车牌号}
    * @param {*} value 要检测的值
    * @returns {boolean} 值是否为车牌号
    * @example
@@ -400,8 +400,8 @@
    *
    * @static
    * @alias module:Validator.isBankCard
-   * @see 参考 {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html|常用银行账号位数参考}
    * @since 1.1.0
+   * @see {@link https://kf.qq.com/faq/170112ABnm6b170112FvquAn.html|常用银行账号位数参考}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.loose=false] 宽松模式，8~30位数字
@@ -477,8 +477,8 @@
    *
    * @static
    * @alias module:Validator.isSocialCreditCode
-   * @see 参考 {@link https://zh.wikisource.org/zh-hans/GB_32100-2015_法人和其他组织统一社会信用代码编码规则|GB 32100-2015 法人和其他组织统一社会信用代码编码规则}
    * @since 1.1.0
+   * @see {@link https://zh.wikisource.org/zh-hans/GB_32100-2015_法人和其他组织统一社会信用代码编码规则|GB 32100-2015 法人和其他组织统一社会信用代码编码规则}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。
@@ -537,7 +537,7 @@
   }
 
   // eslint-disable-next-line no-undef
-  var version = "4.15.3";
+  var version = "4.16.1";
 
   /**
    * 打印警告信息
@@ -681,10 +681,10 @@
   /**
    * 验证密码（数字、大小写字母、特殊字符、非法字符）
    *
-   * @see 参考 {@link https://baike.baidu.com/item/ASCII#3|ASCII}
    * @static
    * @alias module:Validator.validatePassword
    * @since 3.7.0
+   * @see {@link https://baike.baidu.com/item/ASCII#3|ASCII}
    * @param {string} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {number} [options.level=2] 密码强度 1-包含一种字符 2-包含两种字符 3-包含三种字符。（大写字母、小写字母、数字、特殊字符）
@@ -817,11 +817,11 @@
    * <p><strong>注意：该校验只校验是否存在不同字符(大小写字母、数字、特殊符号)，不判断长度。</strong></p>
    * <p><i>如果需要更细致的验证，请使用 <a href="#.validatePassword">validatePassword</a></i></p>
    *
-   * @see 参考 {@link https://baike.baidu.com/item/ASCII#3|ASCII}
    * @static
    * @alias module:Validator.isPassword
-   * @since 1.1.0
    * @requires module:Validator.validatePassword
+   * @since 1.1.0
+   * @see {@link https://baike.baidu.com/item/ASCII#3|ASCII}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {number} [options.level=2] 密码强度 1-包含一种字符 2-包含两种字符 3-包含三种字符。（大写字母、小写字母、数字、特殊字符）
@@ -869,8 +869,8 @@
    *
    * @static
    * @alias module:Validator.isPassport
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/中华人民共和国护照#个人资料页|中华人民共和国护照#个人资料页}
    * @since 1.1.0
+   * @see {@link https://zh.wikipedia.org/wiki/中华人民共和国护照#个人资料页|中华人民共和国护照#个人资料页}
    * @param {*} value 要检测的值
    * @returns {boolean} 值是否为护照号
    * @example
@@ -917,9 +917,9 @@
    * @static
    * @alias module:Validator.isChinese
    * @since 1.1.0
-   * @see 参考 {@link http://www.unicode.org/reports/tr38/#BlockListing|4.4 Listing of Characters Covered by the Unihan Database}
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/Unicode字符平面映射|Unicode字符平面映射}
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/Unicode區段|Unicode区段}
+   * @see {@link http://www.unicode.org/reports/tr38/#BlockListing|4.4 Listing of Characters Covered by the Unihan Database}
+   * @see {@link https://zh.wikipedia.org/wiki/Unicode字符平面映射|Unicode字符平面映射}
+   * @see {@link https://zh.wikipedia.org/wiki/Unicode區段|Unicode区段}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.loose=false] 宽松模式。如果为true，只要包含中文即为true
@@ -1044,7 +1044,7 @@
    * @static
    * @alias module:Validator.isUrl
    * @since 3.4.0
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/统一资源定位符|统一资源定位符}
+   * @see {@link https://zh.wikipedia.org/wiki/统一资源定位符|统一资源定位符}
    * @param {*} value 要检测的值
    * @returns {boolean} 值是否为url
    * @example
@@ -1112,8 +1112,8 @@
    *
    * @static
    * @alias module:Validator.isBusinessLicense
-   * @see 参考 {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html|GS15—2006 工商行政管理市场主体注册号编制规则}
    * @since 3.5.0
+   * @see {@link https://wenku.baidu.com/view/19873704cc1755270722087c.html|GS15—2006 工商行政管理市场主体注册号编制规则}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。
@@ -1450,7 +1450,7 @@
    * @static
    * @alias module:Validator.isHMCard
    * @since 4.0.0
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/港澳居民来往内地通行证|港澳居民来往内地通行证}
+   * @see {@link https://zh.wikipedia.org/wiki/港澳居民来往内地通行证|港澳居民来往内地通行证}
    * @param {*} value 要检测的值
    * @returns {boolean} 是否为港澳居民来往内地通行证
    * @example
@@ -1483,7 +1483,7 @@
    * @static
    * @alias module:Validator.isTWCard
    * @since 4.0.0
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
+   * @see {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.loose=false] 宽松模式。如果为true，表示支持一次性短期通行证
@@ -1517,8 +1517,8 @@
    *
    * @static
    * @alias module:Validator.isSwiftCode
-   * @see 参考 {@link https://zh.wikipedia.org/wiki/ISO_9362|ISO 9362}
    * @since 4.9.0
+   * @see {@link https://zh.wikipedia.org/wiki/ISO_9362|ISO 9362}
    * @param {*} value 要检测的值
    * @returns {boolean} 值是否为 Swift Code
    * @example
@@ -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
    *
@@ -2215,8 +2240,9 @@
   }
 
   /**
-   * 数字转中文数字
-   * 不在安全数字 -9007199254740991～9007199254740991 内，处理会有异常
+   * 数字转中文数字<br/><br/>
+   * 
+   * 如果数字不在安全数字 -9007199254740991～9007199254740991 范围内，处理会有异常。
    *
    * @static
    * @alias module:Processor.numberToChinese
@@ -2421,9 +2447,9 @@
    * @static
    * @alias module:Processor.parseIdCard
    * @since 4.0.0
-   * @see 参考 {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
+   * @see {@link https://baike.baidu.com/item/居民身份证号码|居民身份证号码}
    * @param {string} id 身份证号码，支持15位
-   * @returns {null|IdCardInfo} null 或 省份、生日、性别，省/市/区/年/月/日/性别编码
+   * @returns {IdCardInfo | null} 省份、生日、性别，省/市/区/年/月/日/性别编码。如果解析失败将返回 null 。
    * @example
    * 
    * parseIdCard('123456789123456'); // null
@@ -2485,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 对象，可以将 Blob 转为 Base64/String/ArrayBuffer<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);
@@ -2526,13 +2578,46 @@
     });
   }
 
+  //  file、blob文件如何预览图片？
+
+  /**
+   * 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串<br/><br/>
+   * 
+   * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
+   *
+   * @ignore
+   * @static
+   * @alias module:Processor.blobToDataURL
+   * @since 4.1.0
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader/readAsDataURL|FileReader.readAsDataURL()}
+   * @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 对象
    *
    * @static
    * @alias module:Processor.dataURLToBlob
-   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
    * @since 4.1.0
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Glossary/Base64|Base64}
    * @param {string} dataurl data: 协议的URL
    * @returns {Blob} Blob 对象
    * @example
@@ -2540,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
     });
   }
 
@@ -2560,9 +2646,9 @@
    *
    * @static
    * @alias module:Processor.setDataURLPrefix
-   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs|Data URLs}
-   * @see 参考 {@link https://mimesniff.spec.whatwg.org/#understanding-mime-types|MIME types}
    * @since 4.1.0
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs|Data URLs}
+   * @see {@link https://mimesniff.spec.whatwg.org/#understanding-mime-types|MIME types}
    * @param {string} data 数据本身
    * @param {string} [mimetype="image/png"] MIME 类型
    * @param {boolean} [base64=true] 添加 base64 标识
@@ -2584,16 +2670,39 @@
     return "data:".concat(mimetype).concat(base64 ? ';base64' : '', ",").concat(data);
   }
 
-  // TODO: 函数重载，类型参照 Date
+  /**
+   * @overload
+   * @return {Date}
+   */
 
   /**
-   * 创建一个 Date 实例日期对象，同 new Date() 。<br/>
-   * 规避了苹果设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+   * @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 实例日期对象，同 <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
-   * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
    * @since 4.4.0
+   * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
    * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
    * @param {...number} args 月/日/时/分/秒/毫秒
    * @returns {Date} Date 实例日期对象
@@ -2605,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;
@@ -2617,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);
   }
 
   /**
@@ -2896,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);
     });
   }
 
@@ -2930,8 +3156,8 @@
    * @static
    * @alias module:Other.calculateCursorPosition
    * @since 4.6.0
-   * @see h5示例 {@link https://2950v9.csb.app/|点击查看}
-   * @see react示例 {@link https://33ccy9.csb.app/|点击查看}
+   * @see {@link https://2950v9.csb.app/|h5示例}
+   * @see {@link https://33ccy9.csb.app/|react示例}
    * @param {number} prevPos 赋值前的光标位置，onChange/onInput的光标位置 e.target.selectionEnd
    * @param {string} prevCtrlValue 上一个格式化后的值
    * @param {string} rawValue 当前输入原值
@@ -2975,6 +3201,168 @@
     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 | Promise<AjaxOptions>}
+   */
+
+  /**
+   * @callback TransformResponse
+   * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
+   * @returns {Blob | Promise<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/多用途互聯網郵件擴展|MIME}
+   * @see {@link https://9ykc9s.csb.app/|在线示例}
+   * @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 {(opts: AjaxOptions)=>Promise<AjaxOptions>} */
+        var asyncTransformRequest = function asyncTransformRequest(opts) {
+          // 请求前配置调整
+          var tempOptions = typeof transformRequest === 'function' ? transformRequest(opts) : opts;
+          // @ts-ignore
+          return isPromiseLike(tempOptions) ? tempOptions : Promise.resolve(tempOptions);
+        };
+        /** @type {(res: Blob)=>Promise<Blob>} */
+        var asyncTransformResponse = function asyncTransformResponse(res) {
+          var tempRes = typeof transformResponse === 'function' ? transformResponse(res) : res;
+          // @ts-ignore
+          return isPromiseLike(tempRes) ? tempRes : Promise.resolve(tempRes);
+        };
+
+        // 此处如果使用 async/await 语法糖，编译后的umd代码过大
+        return asyncTransformRequest({
+          responseType: 'blob'
+        }).then(function (ajaxOptions) {
+          return ajax(data, ajaxOptions).then(function (e) {
+            // @ts-ignore
+            return asyncTransformResponse(e.target.response).then(function (res) {
+              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();
@@ -3053,6 +3441,33 @@
     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);
+    });
+  }
+
   /**
    * 转换字段名，返回一个转换字段后的值，不改变原值。
    * 
@@ -3066,7 +3481,7 @@
    * @param {F} fieldNames 字段名映射
    * @param {C} [childrenField] 子级数据字段名
    * @param {'spread'|'self'} [nodeAssign='spread'] 节点赋值方式。spread表示使用展开运算符创建新值，self表示使用自身对象。
-   * @returns {import('./transformFieldNames.type.js').TransformFieldNames<D, F, C>}
+   * @returns {import('./interface.type.js').TransformFieldNames<D, F, C>}
    * @example
    * 
    * const options = [{code: '1', name: 'one'},{code:'2', name:'two'}];
@@ -3586,11 +4001,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;