util-helpers 4.16.0 → 4.16.1

package/esm/blobToDataURL.js

@@ -9,11 +9,11 @@ import fileReader from "./fileReader";
  * 
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
+ * @ignore
  * @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
+ * @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 字符串。

package/esm/calculateCursorPosition.js

@@ -8,8 +8,8 @@ import normalizeString from './normalizeString';
  * @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 当前输入原值

package/esm/dataURLToBlob.js

@@ -3,8 +3,8 @@
  *
  * @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

package/esm/download.js

@@ -5,6 +5,7 @@ import dataURLToBlob from "./dataURLToBlob";
 import isUrl from "./isUrl";
 import ajax from "./ajax";
 import { isBlob } from "./utils/type";
+import isPromiseLike from "./isPromiseLike";
 
 /**
  * 下载文件
@@ -41,13 +42,13 @@ function saver(blobUrl, fileName) {
 /**
  * @callback TransformRequest
  * @param {AjaxOptions} options ajax 配置项
- * @returns {AjaxOptions}
+ * @returns {AjaxOptions | Promise<AjaxOptions>}
  */
 
 /**
  * @callback TransformResponse
  * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
- * @returns {Blob}
+ * @returns {Blob | Promise<Blob>}
  */
 
 /**
@@ -67,7 +68,8 @@ function saver(blobUrl, fileName) {
  * @static
  * @alias module:Other.download
  * @since 4.16.0
- * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展|多用途互联网邮件扩展}
+ * @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>}
@@ -107,21 +109,34 @@ function download(data, options) {
       payload = dataURLToBlob(data);
     } else if (dataType === 'url' || !dataType && isUrl(data)) {
       // url
-      /** @type {AjaxOptions} */
-      var defaultAjaxOptions = {
-        responseType: 'blob'
+      // 包装为异步方法
+      /** @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);
       };
-      // 请求前配置调整
-      var ajaxOptions = typeof transformRequest === 'function' ? transformRequest(defaultAjaxOptions) : defaultAjaxOptions;
-      return ajax(data, ajaxOptions).then(function (e) {
-        /** @type {Blob} */
+      /** @type {(res: Blob)=>Promise<Blob>} */
+      var asyncTransformResponse = function asyncTransformResponse(res) {
+        var tempRes = typeof transformResponse === 'function' ? transformResponse(res) : res;
         // @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)
+        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 {

package/esm/fileReader.js

@@ -20,13 +20,13 @@ var FileReaderMethodMap = {
  */
 
 /**
- * 读取 Blob 或 File 对象<br/><br/>
+ * 读取 Blob 或 File 对象，可以将 Blob 转为 Base64/String/ArrayBuffer<br/><br/>
  * 
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
  * @static
  * @alias module:Processor.fileReader
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader|FileReader}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader|FileReader}
  * @since 4.16.0
  * @param {Blob} blob Blob 或 File 对象
  * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] Blob 或 File 对象

package/esm/index.js

@@ -53,8 +53,8 @@ export { default as padZero } from './padZero';
  *
  * @module Math
  * @since 3.1.0
- * @see 参考 {@link https://github.com/camsong/blog/issues/9|JavaScript 浮点数陷阱及解法}
- * @see 参考 {@link https://2zbuy.csb.app/|JS浮点数计算测试}
+ * @see {@link https://github.com/camsong/blog/issues/9|JavaScript 浮点数陷阱及解法}
+ * @see {@link https://2zbuy.csb.app/|JS浮点数计算测试}
  * @example
  * // 从 4.12.0 版本开始，规范了有效数值。（注意：4.12.3 对有效数值重新定义）
  * // 有效数值即能通过 Number(value) 转为数字，且不能为 NaN 。

package/esm/interface.doc.js

@@ -80,13 +80,13 @@ function ajax(url, options) {}
 /**
  * @callback TransformRequest
  * @param {AjaxOptions} options ajax 配置项
- * @returns {AjaxOptions}
+ * @returns {AjaxOptions | Promise<AjaxOptions>}
  */
 
 /**
  * @callback TransformResponse
  * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
- * @returns {Blob}
+ * @returns {Blob | Promise<Blob>}
  */
 
 /**
@@ -107,6 +107,7 @@ function ajax(url, options) {}
  * @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|TypedArray} data 字符串、blob数据或url地址
  * @param {string|DownloadOptions} [options] 文件名称 或 配置项
  * @returns {Promise<void>}

package/esm/isBankCard.js

@@ -28,8 +28,8 @@ function sumCheckCode(numStr) {
  *
  * @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位数字

package/esm/isBusinessLicense.js

@@ -38,8 +38,8 @@ function sumCheckCode(preCode) {
  *
  * @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，不校验校验位。

package/esm/isChinese.js

@@ -32,9 +32,9 @@ var supportRegExpUnicode = RegExp.prototype.hasOwnProperty('unicode');
  * @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

package/esm/isHMCard.js

@@ -9,7 +9,7 @@ var regHMCard = /^[hm]{1}([0-9]{10}|[0-9]{8})$/i;
  * @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

package/esm/isIdCard.js

@@ -29,8 +29,8 @@ function check(id) {
  * @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位身份证号码

package/esm/isPassport.js

@@ -9,8 +9,8 @@ var reg = /^((e[\da-z])|(de)|(se)|(pe)|([khm][\da-z]))[\da-z]{7}$/i;
  *
  * @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

package/esm/isPassword.js

@@ -5,11 +5,11 @@ import validatePassword from './validatePassword';
  * <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-包含三种字符。（大写字母、小写字母、数字、特殊字符）

package/esm/isSocialCreditCode.js

@@ -44,8 +44,8 @@ function sumCheckCode(preCode) {
  *
  * @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，不校验校验位。

package/esm/isSwiftCode.js

@@ -6,8 +6,8 @@ var reg = /^[A-Z]{6}[A-Z\d]{2}(?:[A-Z\d]{3})?$/;
  *
  * @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

package/esm/isTWCard.js

@@ -12,7 +12,7 @@ var singleRegTWCard = /^[\da-z]{10,12}$/i;
  * @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，表示支持一次性短期通行证

package/esm/isUrl.js

@@ -24,7 +24,7 @@ var regNonProtocal = new RegExp("^(?:".concat(serverReg, ")(?:").concat(portReg,
  * @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

package/esm/isVehicle.js

@@ -8,8 +8,8 @@ var reg = /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕
  *
  * @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

package/esm/normalizeString.js

@@ -6,8 +6,8 @@ import convertToString from './utils/convertToString';
  *
  * @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

package/esm/parseIdCard.js

@@ -69,7 +69,7 @@ var Provinces = [
  * @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 {IdCardInfo | null} 省份、生日、性别，省/市/区/年/月/日/性别编码。如果解析失败将返回 null 。
  * @example

package/esm/safeDate.js

@@ -30,8 +30,8 @@ import _construct from "@babel/runtime/helpers/construct";
  *
  * @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 实例日期对象

package/esm/setDataURLPrefix.js

@@ -4,9 +4,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 标识

package/esm/utils/config.js

@@ -15,5 +15,5 @@ function setDisableWarning(bool) {
 }
 
 // eslint-disable-next-line no-undef
-var version = "4.16.0";
+var version = "4.16.1";
 export { config, setDisableWarning, version };

package/esm/validatePassword.js

@@ -129,10 +129,10 @@ function hasUnallowableCharacter(val, chars) {
 /**
  * 验证密码（数字、大小写字母、特殊字符、非法字符）
  *
- * @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-包含三种字符。（大写字母、小写字母、数字、特殊字符）

package/lib/blobToDataURL.js

@@ -15,11 +15,11 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * 
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
+ * @ignore
  * @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
+ * @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 字符串。

package/lib/calculateCursorPosition.js

@@ -14,8 +14,8 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * @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 当前输入原值

package/lib/dataURLToBlob.js

@@ -9,8 +9,8 @@ exports["default"] = void 0;
  *
  * @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

package/lib/download.js

@@ -8,6 +8,7 @@ var _dataURLToBlob = _interopRequireDefault(require("./dataURLToBlob"));
 var _isUrl = _interopRequireDefault(require("./isUrl"));
 var _ajax = _interopRequireDefault(require("./ajax"));
 var _type = require("./utils/type");
+var _isPromiseLike = _interopRequireDefault(require("./isPromiseLike"));
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 /**
@@ -45,13 +46,13 @@ function saver(blobUrl, fileName) {
 /**
  * @callback TransformRequest
  * @param {AjaxOptions} options ajax 配置项
- * @returns {AjaxOptions}
+ * @returns {AjaxOptions | Promise<AjaxOptions>}
  */
 
 /**
  * @callback TransformResponse
  * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
- * @returns {Blob}
+ * @returns {Blob | Promise<Blob>}
  */
 
 /**
@@ -71,7 +72,8 @@ function saver(blobUrl, fileName) {
  * @static
  * @alias module:Other.download
  * @since 4.16.0
- * @see {@link https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展|多用途互联网邮件扩展}
+ * @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>}
@@ -111,21 +113,34 @@ function download(data, options) {
       payload = (0, _dataURLToBlob["default"])(data);
     } else if (dataType === 'url' || !dataType && (0, _isUrl["default"])(data)) {
       // url
-      /** @type {AjaxOptions} */
-      var defaultAjaxOptions = {
-        responseType: 'blob'
+      // 包装为异步方法
+      /** @type {(opts: AjaxOptions)=>Promise<AjaxOptions>} */
+      var asyncTransformRequest = function asyncTransformRequest(opts) {
+        // 请求前配置调整
+        var tempOptions = typeof transformRequest === 'function' ? transformRequest(opts) : opts;
+        // @ts-ignore
+        return (0, _isPromiseLike["default"])(tempOptions) ? tempOptions : Promise.resolve(tempOptions);
       };
-      // 请求前配置调整
-      var ajaxOptions = typeof transformRequest === 'function' ? transformRequest(defaultAjaxOptions) : defaultAjaxOptions;
-      return (0, _ajax["default"])(data, ajaxOptions).then(function (e) {
-        /** @type {Blob} */
+      /** @type {(res: Blob)=>Promise<Blob>} */
+      var asyncTransformResponse = function asyncTransformResponse(res) {
+        var tempRes = typeof transformResponse === 'function' ? transformResponse(res) : res;
         // @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 || ((0, _type.isBlob)(res) ? res.type : undefined)
+        return (0, _isPromiseLike["default"])(tempRes) ? tempRes : Promise.resolve(tempRes);
+      };
+
+      // 此处如果使用 async/await 语法糖，编译后的umd代码过大
+      return asyncTransformRequest({
+        responseType: 'blob'
+      }).then(function (ajaxOptions) {
+        return (0, _ajax["default"])(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 || ((0, _type.isBlob)(res) ? res.type : undefined)
+            });
+          });
         });
       });
     } else {

package/lib/fileReader.js

@@ -26,13 +26,13 @@ var FileReaderMethodMap = {
  */
 
 /**
- * 读取 Blob 或 File 对象<br/><br/>
+ * 读取 Blob 或 File 对象，可以将 Blob 转为 Base64/String/ArrayBuffer<br/><br/>
  * 
  * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
  *
  * @static
  * @alias module:Processor.fileReader
- * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader|FileReader}
+ * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/API/FileReader|FileReader}
  * @since 4.16.0
  * @param {Blob} blob Blob 或 File 对象
  * @param {'arrayBuffer'|'binaryString'|'dataURL'|'text'} [type='dataURL'] Blob 或 File 对象

package/lib/interface.doc.js

@@ -82,13 +82,13 @@ function ajax(url, options) {}
 /**
  * @callback TransformRequest
  * @param {AjaxOptions} options ajax 配置项
- * @returns {AjaxOptions}
+ * @returns {AjaxOptions | Promise<AjaxOptions>}
  */
 
 /**
  * @callback TransformResponse
  * @param {Blob} res 响应的Blob对象。如果你通过 transformRequest 修改了 responseType ，该参数将是该类型响应值。
- * @returns {Blob}
+ * @returns {Blob | Promise<Blob>}
  */
 
 /**
@@ -109,6 +109,7 @@ function ajax(url, options) {}
  * @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|TypedArray} data 字符串、blob数据或url地址
  * @param {string|DownloadOptions} [options] 文件名称 或 配置项
  * @returns {Promise<void>}

package/lib/isBankCard.js

@@ -34,8 +34,8 @@ function sumCheckCode(numStr) {
  *
  * @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位数字

package/lib/isBusinessLicense.js

@@ -44,8 +44,8 @@ function sumCheckCode(preCode) {
  *
  * @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，不校验校验位。

package/lib/isChinese.js

@@ -39,9 +39,9 @@ var supportRegExpUnicode = RegExp.prototype.hasOwnProperty('unicode');
  * @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

package/lib/isHMCard.js

@@ -15,7 +15,7 @@ var regHMCard = /^[hm]{1}([0-9]{10}|[0-9]{8})$/i;
  * @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

package/lib/isIdCard.js

@@ -35,8 +35,8 @@ function check(id) {
  * @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位身份证号码

package/lib/isPassport.js

@@ -15,8 +15,8 @@ var reg = /^((e[\da-z])|(de)|(se)|(pe)|([khm][\da-z]))[\da-z]{7}$/i;
  *
  * @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

package/lib/isPassword.js

@@ -11,11 +11,11 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  * <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-包含三种字符。（大写字母、小写字母、数字、特殊字符）