util-helpers 4.15.3 → 4.16.0

package/README.md

@@ -53,11 +53,9 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
   - [blobToDataURL](https://doly-dev.github.io/util-helpers/module-Processor.html#.blobToDataURL) - 将 Blob 或 File 对象转成 data:URL 格式的 Base64 字符串
   - [bytesToSize](https://doly-dev.github.io/util-helpers/module-Processor.html#.bytesToSize) - 字节转换为存储单位
   - [dataURLToBlob](https://doly-dev.github.io/util-helpers/module-Processor.html#.dataURLToBlob) - 将 DataURL 转为 Blob 对象
-  - [filterTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.filterTree) - 过滤树节点
   - [formatMoney](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMoney) - 格式化金额
   - [formatMobile](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatMobile) - 格式化手机号码
   - [formatBankCard](https://doly-dev.github.io/util-helpers/module-Processor.html#.formatBankCard) - 格式化银行卡
-  - [listToTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.listToTree) - 列表数据转树结构
   - [normalizeString](https://doly-dev.github.io/util-helpers/module-Processor.html#.normalizeString) - 规整化字符串，如果值为 `undefined` `null` 转为 ''，如果不是字符串类型则转为字符串
   - [numberToChinese](https://doly-dev.github.io/util-helpers/module-Processor.html#.numberToChinese) - 数字转中文数字
   - [padZero](https://doly-dev.github.io/util-helpers/module-Processor.html#.padZero) - 前置补零
@@ -65,6 +63,12 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
   - [replaceChar](https://doly-dev.github.io/util-helpers/module-Processor.html#.replaceChar) - 替换字符，应用场景如：脱敏
   - [safeDate](https://doly-dev.github.io/util-helpers/module-Processor.html#.safeDate) - 创建一个 Date 实例，同 new Date
   - [setDataURLPrefix](https://doly-dev.github.io/util-helpers/module-Processor.html#.setDataURLPrefix) - 设置 DataURL 前缀、MIME 类型、base64 标识
+- 树结构数据操作
+  - [findTreeNode](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeNode) - 查找树结构数据节点
+  - [findTreeNodes](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeNodes) - 查找树结构数据多个节点
+  - [findTreeSelect](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeSelect) - 查找包含当前节点的所有父级节点
+  - [filterTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.filterTree) - 过滤树节点
+  - [listToTree](https://doly-dev.github.io/util-helpers/module-Processor.html#.listToTree) - 列表数据转树结构
   - [transformFieldNames](https://doly-dev.github.io/util-helpers/module-Processor.html#.transformFieldNames) - 转换字段名
   - [treeToList](https://doly-dev.github.io/util-helpers/module-Processor.html#.treeToList) - 树结构转列表数据
 - 数据验证
@@ -92,9 +96,6 @@ formatBankCard('6228480402564890018', { spaceMark: '-' }); // 6228-4804-0256-489
   - [validatePassword](https://doly-dev.github.io/util-helpers/module-Validator.html#.validatePassword) - 验证密码
 - 其他
   - [calculateCursorPosition](https://doly-dev.github.io/util-helpers/module-Other.html#.calculateCursorPosition) - 计算光标位置
-  - [findTreeNode](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeNode) - 查找树结构数据节点
-  - [findTreeNodes](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeNodes) - 查找树结构数据多个节点
-  - [findTreeSelect](https://doly-dev.github.io/util-helpers/module-Other.html#.findTreeSelect) - 查找包含当前节点的所有父级节点
   - [randomString](https://doly-dev.github.io/util-helpers/module-Other.html#.randomString) - 随机字符串
   - [strlen](https://doly-dev.github.io/util-helpers/module-Other.html#.strlen) - 字符长度
   - [waitTime](https://doly-dev.github.io/util-helpers/module-Other.html#.waitTime) - 等待时间返回 Promise

package/dist/util-helpers.js

@@ -537,7 +537,7 @@
   }
 
   // eslint-disable-next-line no-undef
-  var version = "4.15.3";
+  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
    *
@@ -2215,8 +2240,9 @@
   }
 
   /**
-   * 数字转中文数字
-   * 不在安全数字 -9007199254740991～9007199254740991 内，处理会有异常
+   * 数字转中文数字<br/><br/>
+   * 
+   * 如果数字不在安全数字 -9007199254740991～9007199254740991 范围内，处理会有异常。
    *
    * @static
    * @alias module:Processor.numberToChinese
@@ -2423,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
@@ -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 对象<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,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 对象
    *
@@ -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
     });
   }
 
@@ -2584,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
@@ -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);
     });
   }
 
@@ -2975,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();
@@ -3053,6 +3427,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 +3467,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 +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;