util-helpers 4.12.4 → 4.12.7

package/dist/util-helpers.js

@@ -118,6 +118,7 @@
    * @param {*} value 待处理的值
    * @returns {string} 规整化的值
    * @example
+   * 
    * normalizeString(); // ''
    * normalizeString(undefined); // ''
    * normalizeString(void 0); // ''
@@ -127,6 +128,7 @@
    * normalizeString(NaN); // 'NaN'
    * normalizeString(1); // '1'
    * normalizeString('a'); // 'a'
+   * 
    */
 
   function normalizeString(value) {
@@ -148,11 +150,8 @@
    * @returns {boolean} 值是否为手机号码
    * @example
    *
-   * isMobile('13000000000');
-   * // => true
-   *
-   * isMobile('13000');
-   * // => false
+   * isMobile('13000000000'); // true
+   * isMobile('13000'); // false
    *
    */
 
@@ -172,17 +171,14 @@
    * @returns {boolean} 值是否为固定电话
    * @example
    *
-   * isTelephone('22033212');
-   * // => true
-   *
-   * isTelephone('021-22033212');
-   * // => true
-   *
-   * isTelephone('021-22033212-123');
-   * // => true
+   * isTelephone('22033212'); // true
+   * isTelephone('13000000000'); // false
+   * 
+   * // 含区号
+   * isTelephone('021-22033212'); // true
    *
-   * isTelephone('13000000000');
-   * // => false
+   * // 含区号和分机号
+   * isTelephone('021-22033212-123'); // true
    *
    */
 
@@ -202,11 +198,8 @@
    * @returns {boolean} 值是否为邮政编码
    * @example
    *
-   * isPostcode('101111');
-   * // => true
-   *
-   * isPostcode('123');
-   * // => false
+   * isPostcode('101111'); // true
+   * isPostcode('123'); // false
    *
    */
 
@@ -254,20 +247,17 @@
    * @returns {boolean} 值是否为身份证号
    * @example
    *
-   * isIdCard('130701199310302288');
-   * // => true
-   *
-   * isIdCard('13070119931030228X');
-   * // => false
-   *
-   * isIdCard('13070119931030228X', { checkCode: false }); // 不校验校验码
-   * // => true
+   * isIdCard('130701199310302288'); // true
+   * isIdCard('13070119931030228X'); // false
    *
-   * isIdCard('320311770706001');
-   * // => false
+   * // 不校验校验码
+   * isIdCard('13070119931030228X', { checkCode: false }); // true
    *
-   * isIdCard('320311770706001', { loose: true });
-   * // => true
+   * // 默认不支持15位身份证号码
+   * isIdCard('320311770706001'); // false
+   * 
+   * // 宽松模式，支持15位身份证号
+   * isIdCard('320311770706001', { loose: true }); // true
    *
    */
 
@@ -307,11 +297,8 @@
    * @returns {boolean} 值是否为Email
    * @example
    *
-   * isEmail('1232@qq.com');
-   * // => true
-   *
-   * isEmail('123@');
-   * // => false
+   * isEmail('1232@qq.com'); // true
+   * isEmail('123@'); // false
    *
    */
 
@@ -331,11 +318,8 @@
    * @returns {boolean} 值是否为QQ号
    * @example
    *
-   * isQQ('12345');
-   * // => true
-   *
-   * isQQ('123');
-   * // => false
+   * isQQ('12345'); // true
+   * isQQ('123'); // false
    *
    */
 
@@ -355,11 +339,8 @@
    * @returns {boolean} 值是否为微信号
    * @example
    *
-   * isWX('a12345');
-   * // => true
-   *
-   * isWX('123');
-   * // => false
+   * isWX('a12345'); // true
+   * isWX('123'); // false
    *
    */
 
@@ -380,20 +361,15 @@
    * @returns {boolean} 值是否为车牌号
    * @example
    *
-   * isVehicle('京L12345');
-   * // => true
-   *
-   * isVehicle('粤BD12345');
-   * // => true
-   *
-   * isVehicle('粤BF12345');
-   * // => true
-   *
-   * isVehicle('粤B12345D');
-   * // => true
-   *
-   * isVehicle('粤B12345F');
-   * // => true
+   * isVehicle('京L12345'); // true
+   * isVehicle('京L1234学'); // true
+   * isVehicle('BL1234警'); // true
+   * 
+   * // 新能源车牌
+   * isVehicle('粤BD12345'); // true
+   * isVehicle('粤BF12345'); // true
+   * isVehicle('粤B12345D'); // true
+   * isVehicle('粤B12345F'); // true
    *
    */
 
@@ -438,17 +414,12 @@
    * @returns {boolean} 值是否为银行卡号
    * @example
    *
-   * isBankCard('6228480402564890018');
-   * // => true
-   *
-   * isBankCard('6228480402564890');
-   * // => true
-   *
-   * isBankCard('123456789');
-   * // => false
-   *
-   * isBankCard('123456789', { loose: true });
-   * // => true
+   * isBankCard('6228480402564890018'); // true
+   * isBankCard('6228480402564890'); // true
+   * isBankCard('123456789'); // false
+   * 
+   * // 宽松模式
+   * isBankCard('123456789', { loose: true }); // true
    *
    */
 
@@ -521,18 +492,13 @@
    * @returns {boolean} 值是否为统一社会信用代码
    * @example
    *
-   * isSocialCreditCode('91350100M000100Y43');
-   * // => true
-   *
-   * isSocialCreditCode('91350100M000100Y4A');
-   * // => false
-   *
-   * // 不校验校验位
-   * isSocialCreditCode('91350100M000100Y4A', { checkCode: false });
-   * // => true
+   * isSocialCreditCode('91350100M000100Y43'); // true
+   * isSocialCreditCode('91350100M000100Y4A'); // false
    *
-   * isSocialCreditCode('91350100M000100Y', { checkCode: false });
-   * // => false
+   * // 不校验校验位，长度和类型还是有校验的
+   * isSocialCreditCode('91350100M000100Y4A', { checkCode: false }); // true
+   * isSocialCreditCode('91350100M000100YIO', { checkCode: false }); // false
+   * isSocialCreditCode('91350100M000100Y', { checkCode: false }); // false
    *
    */
 
@@ -562,7 +528,7 @@
     return lastCode === checkCode;
   }
 
-  const version = "4.12.4";
+  const version = "4.12.7";
 
   var config = {
     // 禁用warning提示
@@ -896,27 +862,20 @@
    * @returns {boolean} 值是否符合密码强度
    * @example
    *
-   * isPassword('a12345678');
-   * // => true
-   *
-   * isPassword('a12345678', {level: 3});
-   * // => false
-   *
-   * isPassword('Aa12345678', {level: 3});
-   * // => true
-   *
-   * isPassword('Aa12345678', {level: 3, ignoreCase: true});
-   * // => false
-   *
-   * isPassword('_Aa12345678', {level: 3, ignoreCase: true});
-   * // => true
-   *
-   * // 仅支持 数字、字母、特殊字符，其他字符如中文字符是校验不通过的
-   * isPassword('_Aa一二三45678', {level: 3, ignoreCase: true});
-   * // => false
+   * isPassword('a12345678'); // true
+   * 
+   * // 3级密码强度
+   * isPassword('a12345678', {level: 3}); // false
+   * isPassword('Aa12345678', {level: 3}); // true
+   * 
+   * // 3级密码强度，大小写字符仅计算1级强度
+   * isPassword('Aa12345678', {level: 3, ignoreCase: true}); // false
+   * isPassword('_Aa12345678', {level: 3, ignoreCase: true}); // true
    *
-   * isPassword(' _Aa12345678', {level: 3, ignoreCase: true});
-   * // => false
+   * // 仅支持 数字、字母、特殊字符，其他非法字符如中文字符是校验不通过的
+   * isPassword('_Aa一二三45678', {level: 3, ignoreCase: true}); // false
+   * isPassword(' _Aa12345678', {level: 3, ignoreCase: true}); // false
+   * 
    */
 
   function isPassword(value) {
@@ -948,11 +907,8 @@
    * @returns {boolean} 值是否为护照号
    * @example
    *
-   * isPassport('E12345678');
-   * // => true
-   *
-   * isPassport('abc');
-   * // => false
+   * isPassport('E12345678'); // true
+   * isPassport('abc'); // false
    *
    */
 
@@ -1000,27 +956,20 @@
    * @returns {boolean} 值是否为中文
    * @example
    *
-   * isChinese('林某某');
-   * // => true
-   *
-   * isChinese('林A');
-   * // => false
+   * isChinese('林某某'); // true
+   * isChinese('林A'); // false
    *
    * // 宽松模式，只要包含中文即为true
-   * isChinese('林A', { loose: true });
-   * // => true
-   *
-   * isChinese('A林A', { loose: true });
-   * // => true
-   *
-   * isChinese('𠮷');
-   * // => false
+   * isChinese('林A', { loose: true }); // true
+   * isChinese('A林A', { loose: true }); // true
    *
+   * // 扩展字符集的字符
+   * isChinese('𠮷'); // false
+   * 
    * // 使用中文扩展字符集，需要浏览器支持 RegExp.prototype.unicode 才生效。
-   * isChinese('𠮷', { useExtend: true });
-   * // => true
-   * isChinese('𠮷aa', { useExtend: true, loose: true });
-   * // => true
+   * isChinese('𠮷', { useExtend: true }); // true
+   * isChinese('𠮷aa', { useExtend: true, loose: true }); // true
+   * 
    */
 
   function isChinese(value) {
@@ -1051,17 +1000,10 @@
    * @returns {boolean} 值是否为ipv4
    * @example
    *
-   * isIPv4('192.168.1.1');
-   * // => true
-   *
-   * isIPv4('255.255.255.255');
-   * // => true
-   *
-   * isIPv4('256.256.256.256');
-   * // => false
-   *
-   * isIPv4('0.0');
-   * // => false
+   * isIPv4('192.168.1.1'); // true
+   * isIPv4('255.255.255.255'); // true
+   * isIPv4('256.256.256.256'); // false
+   * isIPv4('0.0'); // false
    *
    */
 
@@ -1082,41 +1024,23 @@
    * @example
    *
    * // 冒分十六进制表示法
-   * isIPv6('2001:0DB8:0000:0023:0008:0800:200C:417A');
-   * // => true
+   * isIPv6('2001:0DB8:0000:0023:0008:0800:200C:417A'); // true
    *
    * // 前导0省略
-   * isIPv6('2001:DB8:0:23:8:800:200C:417A');
-   * // => true
-   *
-   * isIPv6('FF01:0:0:0:0:0:0:1101');
-   * // => true
+   * isIPv6('2001:DB8:0:23:8:800:200C:417A'); // true
+   * isIPv6('FF01:0:0:0:0:0:0:1101'); // true
    *
    * // 0位压缩表示法
-   * isIPv6('FF01::1101');
-   * // => true
-   *
-   * isIPv6('::1');
-   * // => true
-   *
-   * isIPv6('::');
-   * // => true
-   *
-   * isIPv6('0:0:0:0:0:0:0:1');
-   * // => true
-   *
-   * isIPv6('0:0:0:0:0:0:0:0');
-   * // => true
+   * isIPv6('FF01::1101'); // true
+   * isIPv6('::1'); // true
+   * isIPv6('::'); // true
+   * isIPv6('0:0:0:0:0:0:0:1'); // true
+   * isIPv6('0:0:0:0:0:0:0:0'); // true
    *
    * // 内嵌IPv4地址表示法
-   * isIPv6('::192.168.1.1');
-   * // => true
-   *
-   * isIPv6('::FFFF:192.168.1.1');
-   * // => true
-   *
-   * isIPv6('192.168.1.1');
-   * // => false
+   * isIPv6('::192.168.1.1'); // true
+   * isIPv6('::FFFF:192.168.1.1'); // true
+   * isIPv6('192.168.1.1'); // false
    *
    */
 
@@ -1137,26 +1061,14 @@
    * @returns {boolean} 值是否为url
    * @example
    *
-   * isUrl('');
-   * // => false
-   *
-   * isUrl('8.8.8.8');
-   * // => false
-   *
-   * isUrl('example.com');
-   * // => true
-   *
-   * isUrl('http://example.com');
-   * // => true
-   *
-   * isUrl('https://example.com:8080');
-   * // => true
-   *
-   * isUrl('http://www.example.com/test/123');
-   * // => true
-   *
-   * isUrl('http://www.example.com/test/123?foo=bar');
-   * // => true
+   * isUrl(''); // false
+   * isUrl('8.8.8.8'); // false
+   * isUrl('example.com'); // true
+   * isUrl('http://example.com'); // true
+   * isUrl('https://example.com:8080'); // true
+   * isUrl('http://www.example.com/test/123'); // true
+   * isUrl('http://www.example.com/test/123?foo=bar'); // true
+   * 
    */
 
   function isUrl(value) {
@@ -1209,17 +1121,14 @@
    * @returns {boolean} 值是否为营业执照号
    * @example
    *
-   * isBusinessLicense('310115600985533');
-   * // => true
-   *
-   * isBusinessLicense('310115600985535');
-   * // => false
+   * isBusinessLicense('310115600985533'); // true
+   * isBusinessLicense('310115600985535'); // false
    *
-   * isBusinessLicense('310115600985535', { checkCode: false });
-   * // => true
-   *
-   * isBusinessLicense('31011560098', { checkCode: false });
-   * // => false
+   * // 不校验验证码，长度和类型还是有校验
+   * isBusinessLicense('310115600985535', { checkCode: false }); // true
+   * isBusinessLicense('ac115600985535', { checkCode: false }); // false
+   * isBusinessLicense('31011560098', { checkCode: false }); // false
+   * 
    */
 
 
@@ -1466,14 +1375,10 @@
    * @returns {boolean} 是否类似Promise对象
    * @example
    *
-   * isPromiseLike([]);
-   * => false
-   *
-   * isPromiseLike({then:()=>{}});
-   * => true
-   *
-   * isPromiseLike(Promise.resolve());
-   * => true
+   * isPromiseLike([]); // false
+   * isPromiseLike({ then: () => { } }); // true
+   * isPromiseLike(Promise.resolve()); // true
+   * 
    */
   function isPromiseLike(obj) {
     return obj !== null && (_typeof(obj) === 'object' || typeof obj === 'function') && typeof obj.then === 'function';
@@ -1491,16 +1396,16 @@
    * @returns {boolean} 是否为港澳居民来往内地通行证
    * @example
    * // 第一代 11 位
-   * isHMCard('h3203117707') // true
-   * isHMCard('H3203117707') // true
-   * isHMCard('m3203117707') // true
-   * isHMCard('M3203117707') // true
+   * isHMCard('h3203117707'); // true
+   * isHMCard('H3203117707'); // true
+   * isHMCard('m3203117707'); // true
+   * isHMCard('M3203117707'); // true
    *
    * // 第二代 9 位
-   * isHMCard('h32031177') // true
-   * isHMCard('H32031177') // true
-   * isHMCard('m32031177') // true
-   * isHMCard('M32031177') // true
+   * isHMCard('h32031177'); // true
+   * isHMCard('H32031177'); // true
+   * isHMCard('m32031177'); // true
+   * isHMCard('M32031177'); // true
    */
 
   function isHMCard(value) {
@@ -1523,12 +1428,15 @@
    * @param {boolean} [options.loose=false] 宽松模式。如果为true，表示支持一次性短期通行证
    * @returns {boolean} 是否为台湾居民来往大陆通行证
    * @example
-   * isTWCard('12345678') // true
-   * isTWCard('07257456') // true
+   * 
+   * isTWCard('12345678'); // true
+   * isTWCard('07257456'); // true
    *
    * // 一次性短期
-   * isTWCard('F290299977') // false
-   * isTWCard('F290299977', { loose: true }) // true
+   * isTWCard('F290299977'); // false
+   * 
+   * // 宽松模式，支持一次性短期通行证
+   * isTWCard('F290299977', { loose: true }); // true
    */
 
   function isTWCard(value) {
@@ -1557,13 +1465,13 @@
    * @returns {boolean} 值是否为 Swift Code
    * @example
    *
-   * isSwiftCode('DEUTDEFF') //  true
-   * isSwiftCode('deutdeff') //  false
+   * isSwiftCode('DEUTDEFF'); // true
+   * isSwiftCode('deutdeff'); // false
    *
-   * isSwiftCode('BKTWTWTP010') //  true
-   * isSwiftCode('010BKTWTWTP') //  false
+   * isSwiftCode('BKTWTWTP010'); // true
+   * isSwiftCode('010BKTWTWTP'); // false
    *
-   * isSwiftCode('ICBKCNBJBJM') //  true
+   * isSwiftCode('ICBKCNBJBJM'); // true
    *
    */
 
@@ -1676,18 +1584,13 @@
         ret = Number.NaN;
       }
     } else if (isSymbol(value)) {
-      ret = Number.NaN;
-    } else if (!isNumber(value)) {
-      // 其余非数字类型通过 Number 转换
       // 例如 Symbol 包装器对象将会报错
       // symObj = Object(Symbol());
       // Number(symObj); // TypeError: Cannot convert a Symbol value to a number
-      try {
-        ret = Number(value);
-      } catch (err) {
-        ret = Number.NaN;
-        console.error(err);
-      }
+      ret = Number.NaN;
+    } else if (!isNumber(value)) {
+      // 其余非数字类型通过 Number 转换
+      ret = Number(value);
     } else {
       ret = value;
     }
@@ -1943,32 +1846,26 @@
    * @example
    *
    * // 整数
-   * formatMoney('1000');
-   * // => 1,000.00
+   * formatMoney('1000'); // 1,000.00
    *
    * // 小数（默认保留2位小数）
-   * formatMoney('3000.03');
-   * // => 3,000.03
+   * formatMoney('3000.03'); // 3,000.03
    *
    * // 保留4位小数
-   * formatMoney('3000.0300', { precision: 4 });
-   * // => 3,000.0300
+   * formatMoney('3000.0300', { precision: 4 }); // 3,000.0300
    *
    * // 保留10位小数
-   * formatMoney('1500.2', { precision: 10 });
-   * // => 1,500.2000000000
+   * formatMoney('1500.2', { precision: 10 }); // 1,500.2000000000
    *
    * // 自定义单位符号
-   * formatMoney(1000.00, { symbol: '$' });
-   * // => $1,000.00
+   * formatMoney(1000.00, { symbol: '$' }); // $1,000.00
    *
    * // 自定义千位分割符（默认','）
-   * formatMoney(1000.00, { thousand: '|' });
-   * // => 1|000.00
+   * formatMoney(1000.00, { thousand: '|' }); // 1|000.00
    *
    * // 自定义小数位分割符(默认'.')
-   * formatMoney(1000.00, { decimal: '&' });
-   * // => 1,000&00
+   * formatMoney(1000.00, { decimal: '&' }); // 1,000&00
+   * 
    */
 
 
@@ -2023,20 +1920,16 @@
    * @example
    *
    * // 19位银行卡
-   * formatBankCard('6228480402564890018');
-   * // => 6228 4804 0256 4890 018
+   * formatBankCard('6228480402564890018'); // 6228 4804 0256 4890 018
    *
    * // 16位银行卡
-   * formatBankCard('6228480402564890');
-   * // => 6228 4804 0256 4890
+   * formatBankCard('6228480402564890'); // 6228 4804 0256 4890
    *
    * // 脱敏银行卡
-   * formatBankCard('6228********890');
-   * // => 6228 **** **** 890
+   * formatBankCard('6228********890'); // 6228 **** **** 890
    *
    * // 16位银行卡，"-"间隔
-   * formatBankCard('6228480402564890', {char: '-'});
-   * // => 6228-4804-0256-4890
+   * formatBankCard('6228480402564890', {char: '-'}); // 6228-4804-0256-4890
    *
    */
 
@@ -2073,33 +1966,25 @@
    * @example
    *
    * // 手机号
-   * replaceChar('13000000000');
-   * // => 130****0000
+   * replaceChar('13000000000'); // 130****0000
    *
    * // 身份证
-   * replaceChar('130701199310302288');
-   * // => 130***********2288
+   * replaceChar('130701199310302288'); // 130***********2288
    *
    * // 邮箱
    * const email = '12345@qq.com'
-   * replaceChar(email, {start: 2, end: email.indexOf('@'), repeat: 4});
-   * // => 12****@qq.com
+   * replaceChar(email, {start: 2, end: email.indexOf('@'), repeat: 4}); // 12****@qq.com
    *
    * // 银行卡号
-   * replaceChar('6228480402564890018', {start: 0, end: -4, repeat: 4});
-   * // => ****0018
+   * replaceChar('6228480402564890018', {start: 0, end: -4, repeat: 4}); // ****0018
    *
-   * // 带格式的银行卡号
-   * replaceChar('6228 4804 0256 4890 018', {start: 4, end: -4, exclude: ' '});
-   * // => 6228 **** **** **** 018
+   * // 带格式的银行卡号，忽略空字符串
+   * replaceChar('6228 4804 0256 4890 018', {start: 4, end: -4, exclude: ' '}); // 6228 **** **** **** 018
    *
    * // 用户名
-   * replaceChar('林某某', {start: 1, end: Infinity, repeat: 2});
-   * // => 林**
-   * replaceChar('林某', {start: 1, end: Infinity, repeat: 2});
-   * // => 林**
-   * replaceChar('林某某某', {start: 1, end: Infinity, repeat: 2});
-   * // => 林**
+   * replaceChar('林某某', {start: 1, end: Infinity, repeat: 2}); // 林**
+   * replaceChar('林某', {start: 1, end: Infinity, repeat: 2}); // 林**
+   * replaceChar('林某某某', {start: 1, end: Infinity, repeat: 2}); // 林**
    *
    */
 
@@ -2291,7 +2176,7 @@
    * @param {Object} [options] 配置项
    * @param {boolean} [options.big5=false] 繁体
    * @param {boolean} [options.unit=true] 计数单位
-   * @param {string} [options.decimal="点"] 中文小数点
+   * @param {string} [options.decimal="点"] 中文小数点，繁体字为點
    * @param {string} [options.zero="零"] 设置0。常用配置 〇
    * @param {string} [options.negative="负"] 负数前面的字
    * @param {Object} [options.unitConfig] 节点单位配置
@@ -2300,29 +2185,21 @@
    * @returns {string} 中文数字
    * @example
    *
-   * numberToChinese(100);
-   * // => 一百
-   *
-   * numberToChinese(100.3);
-   * // => 一百点三
+   * numberToChinese(100); // 一百
+   * numberToChinese(100.3); // 一百点三
+   * numberToChinese(1234567890); // 一十二亿三千四百五十六万七千八百九十
+   * numberToChinese(1234567890.11); // 一十二亿三千四百五十六万七千八百九十点一一
    *
    * // 繁体
-   * numberToChinese(100, {big5: true});
-   * // => 壹佰
-   *
-   * numberToChinese(100.3, {big5: true});
-   * // => 壹佰点叁
-   *
-   * numberToChinese(1234567890, {big5: true});
-   * // => 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾
+   * numberToChinese(100, {big5: true}); // 壹佰
+   * numberToChinese(100.3, {big5: true}); // 壹佰點叁
+   * numberToChinese(1234567890.11, {big5: true}); // 壹拾贰亿叁仟肆佰伍拾陆万柒仟捌佰玖拾點壹壹
    *
    * // 不带计数单位
-   * numberToChinese(1990, {unit: false});
-   * // => 一九九零
+   * numberToChinese(1990, {unit: false}); // 一九九零
    *
    * // 不带计数单位，修改0
-   * numberToChinese(1990, {unit: false, zero:'〇'});
-   * // => 一九九〇
+   * numberToChinese(1990, {unit: false, zero:'〇'}); // 一九九〇
    *
    */
 
@@ -2334,7 +2211,7 @@
         _ref$unit = _ref.unit,
         unit = _ref$unit === void 0 ? true : _ref$unit,
         _ref$decimal = _ref.decimal,
-        decimal = _ref$decimal === void 0 ? '点' : _ref$decimal,
+        decimal = _ref$decimal === void 0 ? '' : _ref$decimal,
         _ref$zero = _ref.zero,
         zero = _ref$zero === void 0 ? '' : _ref$zero,
         _ref$negative = _ref.negative,
@@ -2354,9 +2231,11 @@
     if (big5) {
       numberChar = big5NumberChar.slice();
       unitChar = big5UnitChar.slice();
+      decimal = decimal || '點';
     } else {
       numberChar = chnNumberChar.slice();
       unitChar = chnUnitChar.slice();
+      decimal = decimal || '点';
     } // 设置节点计数单位，万、亿、万亿
 
 
@@ -2396,17 +2275,11 @@
    * @returns {string} 存储单位值
    * @example
    *
-   * bytesToSize(0);
-   * // => 0 B
-   *
-   * bytesToSize(1024);
-   * // => 1 KB
-   *
-   * bytesToSize(3.213243*1024*1024);
-   * // => 3.21 MB
-   *
-   * bytesToSize(1024*1024*1024);
-   * // => 1 GB
+   * bytesToSize(0); // 0 B
+   * bytesToSize(1024); // 1 KB
+   * bytesToSize(3.213243*1024*1024); // 3.21 MB
+   * bytesToSize(1024*1024*1024); // 1 GB
+   * 
    */
   function bytesToSize(bytes) {
     var numBytes = typeof bytes !== 'number' ? Number(bytes) : bytes;
@@ -2479,11 +2352,11 @@
    * @param {string} id 身份证号码，支持15位
    * @returns {null|IdCardInfo} null 或 省份、生日、性别，省/市/区/年/月/日/性别编码
    * @example
-   * parseIdCard('123456789123456');
-   * // => null
+   * 
+   * parseIdCard('123456789123456'); // null
    *
    * // 18位身份证号码
-   * parseIdCard('130701199310302288')
+   * parseIdCard('130701199310302288'); 
    * // =>
    * {
    *   birthday: "1993-10-30",
@@ -2505,24 +2378,17 @@
    */
 
   function parseIdCard(id) {
-    if (!isIdCard(id, {
-      loose: true
-    })) {
+    if (!regIdCard.test(id)) {
       return null;
     }
+    /** @type {RegExpExecArray} */
+    // @ts-ignore
 
-    var info = regIdCard.exec(id);
 
-    if (!info) {
-      return null;
-    }
-    /**
-     * @type {{ province: string, city: string, area: string, year: string, month: string, day: string, gender: string }}
-     *
-     */
+    var info = regIdCard.exec(id);
+    /** @type {{ province: string, city: string, area: string, year: string, month: string, day: string, gender: string }} */
     // @ts-ignore
 
-
     var origin = (info === null || info === void 0 ? void 0 : info.groups) || {
       province: info[1],
       city: info[2],
@@ -2605,7 +2471,7 @@
    * @returns {Blob} Blob 对象
    * @example
    * const dataurl = 'data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
-   * dataURLToBlob(dataurl);
+   * dataURLToBlob(dataurl); // Blob {size: 32, type: 'text/html'}
    */
   function dataURLToBlob(dataurl) {
     var arr = dataurl.split(','); // @ts-ignore
@@ -2638,6 +2504,7 @@
    * @param {boolean} [base64=true] 添加 base64 标识
    * @returns {string} DataURL 格式的字符串
    * @example
+   * 
    * const data = 'PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=';
    * setDataURLPrefix(data); // data:image/png;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
    * setDataURLPrefix(data, 'image/png', false); // data:image/png,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
@@ -2645,6 +2512,7 @@
    * setDataURLPrefix(data, 'text/html'); // data:text/html;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
    * setDataURLPrefix(data, ''); // data:;base64,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
    * setDataURLPrefix(data, '', false); // data:,PGEgaWQ9ImEiPjxiIGlkPSJiIj5oZXkhPC9iPjwvYT4=
+   * 
    */
   function setDataURLPrefix(data) {
     var mimetype = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'image/png';
@@ -2664,12 +2532,14 @@
    * @param {...number} args 月/日/时/分/秒/毫秒
    * @returns {Date} Date 实例日期对象
    * @example
+   * 
    * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
    * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
    * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
    * 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 (中国标准时间)
+   * 
    *
    */
 
@@ -2700,17 +2570,19 @@
    * @param {string} [options.char=' '] 间隔字符
    * @returns {string} 格式化后的手机号码
    * @example
-   * formatMobile('13345678900') // '133 4567 8900'
-   * formatMobile('13345678900', { char: '-' }) // '133-4567-8900'
+   * 
+   * formatMobile('13345678900'); // 133 4567 8900
+   * formatMobile('13345678900', { char: '-' }); // 133-4567-8900
    *
    * // 脱敏手机号码
-   * formatMobile('133****1234') // '133 **** 1234'
-   * formatMobile('133****1234', { char: '-' }) // '133-****-1234'
+   * formatMobile('133****1234'); // 133 **** 1234
+   * formatMobile('133****1234', { char: '-' }); // 133-****-1234
    *
    * // 手机号码位数不够
-   * formatMobile('133') // '133'
-   * formatMobile('133456') // '133 456'
-   * formatMobile('13345678') // '133 4567 8'
+   * formatMobile('133'); // 133
+   * formatMobile('133456'); // 133 456
+   * formatMobile('13345678'); // 133 4567 8
+   * 
    */
 
   function formatMobile(mobileNo) {
@@ -2742,17 +2614,18 @@
    * @param {number} [size=2] 指定字符串长度
    * @returns {string} 用零填充数字到给定长度的字符串
    * @example
-   * padZero(5); // '05'
-   * padZero('5'); // '05'
+   * padZero(5); // 05
+   * padZero('5'); // 05
    *
-   * padZero(12); // '12'
-   * padZero('12'); // '12'
+   * padZero(12); // 12
+   * padZero('12'); // 12
    *
-   * padZero(688); // '688'
-   * padZero('688'); // '688'
+   * padZero(688); // 688
+   * padZero('688'); // 688
    *
-   * padZero(688, 5); // '00688'
-   * padZero('688', 5); // '00688'
+   * padZero(688, 5); // 00688
+   * padZero('688', 5); // 00688
+   * 
    */
 
   function padZero(value) {
@@ -2781,14 +2654,10 @@
    * @returns {number} 乘积
    * @example
    *
-   * times(3, 0.6);
-   * // => 1.8
-   *
-   * times(3, 0.6, 2);
-   * // => 3.6
-   *
-   * times(3, 0.6, 2, 10);
-   * // => 36
+   * times(3, 0.6); // 1.8
+   * times(3, 0.6, 2); // 3.6
+   * times(3, 0.6, 2, 10); // 36
+   * 
    */
 
   function times() {
@@ -2831,14 +2700,10 @@
    * @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
+   * 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
+   * 
    */
 
   function plus() {
@@ -2877,14 +2742,10 @@
    * @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
+   * 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() {
@@ -2931,6 +2792,7 @@
    * 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() {
@@ -2974,14 +2836,10 @@
    * @returns {number} 四舍五入的数字
    * @example
    *
-   * round(4.006);
-   * // => 4
-   *
-   * round(4.006, 2);
-   * // => 4.01
-   *
-   * round(4060, -2);
-   * // => 4100
+   * round(4.006); // 4
+   * round(4.006, 2); // 4.01
+   * round(4060, -2); // 4100
+   * 
    */
 
   function round(num) {
@@ -3006,6 +2864,7 @@
    * @param {number} [time=1000] 延时时间，单位毫秒
    * @returns {Promise<void>}
    * @example
+   * 
    * const test = async ()=>{
    *   await waitTime();
    *   // do something
@@ -3013,7 +2872,8 @@
    *
    * waitTime(500).then(()=>{
    *   // do something
-   * })
+   * });
+   * 
    */
   function waitTime() {
     var time = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 1000;
@@ -3115,12 +2975,14 @@
    * @param {string} [optionalChars='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 允许的字符，默认为数字和大小写字母
    * @returns {string} 随机字符串
    * @example
+   * 
    * randomString(5); // slk23
    * randomString(8); // 71mHqo2A
    *
    * // 自定义允许的字符
    * randomString(5, 'abc'); // ccbcb
    * randomString(8, 'abcefg'); // bcgcfabg
+   * 
    */