util-helpers 4.8.2 → 4.10.0

package/README.md

@@ -1,6 +1,6 @@
 # util-helpers
 
-[![npm][npm]][npm-url] ![GitHub](https://img.shields.io/github/license/doly-dev/util-helpers.svg) [![Build Status](https://travis-ci.org/doly-dev/util-helpers.svg?branch=master)](https://travis-ci.org/doly-dev/util-helpers)
+[![npm][npm]][npm-url] ![GitHub](https://img.shields.io/github/license/doly-dev/util-helpers.svg)
 
 [util-helpers](https://doly-dev.github.io/util-helpers/index.html) 是一个基于业务场景的工具方法库。
 
@@ -70,6 +70,7 @@ formatMoney('1000'); // => 1,000.00
   - [isVehicle](https://doly-dev.github.io/util-helpers/module-Validator.html#.isVehicle) - 车牌号
   - [isBankCard](https://doly-dev.github.io/util-helpers/module-Validator.html#.isBankCard) - 银行卡
   - [isSocialCreditCode](https://doly-dev.github.io/util-helpers/module-Validator.html#.isSocialCreditCode) - 统一社会信用代码，也叫三证合一组织代码
+  - [isSwiftCode](https://doly-dev.github.io/util-helpers/module-Validator.html#.isSwiftCode) - Swift Code
   - [isPassword](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPassword) 密码强度
   - [isPassport](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPassport) - 护照号
   - [isPromiseLike](https://doly-dev.github.io/util-helpers/module-Validator.html#.isPromiseLike) - 类似 Promise 对象
@@ -82,6 +83,7 @@ formatMoney('1000'); // => 1,000.00
 - 其他
   - [calculateCursorPosition](https://doly-dev.github.io/util-helpers/module-Other.html#.calculateCursorPosition) - 计算光标位置
   - [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

@@ -4,6 +4,62 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.utilHelpers = {}));
 }(this, (function (exports) { 'use strict';
 
+  /**
+   * 检查值是否为Undefined
+   *
+   * @static
+   * @alias module:Type.isUndefined
+   * @since 1.1.0
+   * @param {*} value 检查值
+   * @returns {boolean} 是否为Undefined
+   * @example
+   *
+   * isUndefined(undefined)
+   * // => true
+   *
+   * isUndefined(void 0)
+   * // => true
+   *
+   * isUndefined(null)
+   * // => false
+   */
+  function isUndefined(value) {
+    return value === void 0;
+  }
+
+  /**
+   * 检查值是否为Null
+   *
+   * @static
+   * @alias module:Type.isNull
+   * @since 1.1.0
+   * @param {*} value 检查值
+   * @returns {boolean} 是否为Null
+   * @example
+   *
+   * isNull(null)
+   * // => true
+   *
+   * isNull(void 0)
+   * // => false
+   */
+  function isNull(value) {
+    return value === null;
+  }
+
+  /**
+   * 检查值是否为 undefined 或 null
+   *
+   * @static
+   * @alias module:Type.isNaN
+   * @since 4.3.0
+   * @param {*} value 检查值
+   * @returns {boolean} 是否为 undefined 或 null
+   */
+  function isNil(value) {
+    return isUndefined(value) || isNull(value);
+  }
+
   const toString = Object.prototype.toString;
 
   /**
@@ -49,8 +105,35 @@
     return isString(value) ? value : String(value);
   }
 
+  /**
+   * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
+   *
+   * @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
+   * @param {*} value 待处理的值
+   * @returns {string} 规整化的值
+   * @example
+   * normalizeString(); // ''
+   * normalizeString(undefined); // ''
+   * normalizeString(void 0); // ''
+   * normalizeString(null); // ''
+   *
+   * normalizeString(true); // 'true'
+   * normalizeString(NaN); // 'NaN'
+   * normalizeString(1); // '1'
+   * normalizeString('a'); // 'a'
+   */
+  function normalizeString(value) {
+    if (isNil(value)) {
+      return '';
+    }
+    return convertToString(value);
+  }
+
   // 手机号码 11位数字，以1开头，第二位是3456789其中一个，后面再加9个数字
-  const reg$c = /^1[3456789]\d{9}$/;
+  const reg$d = /^1[3456789]\d{9}$/;
 
   /**
    * 检测值是否为手机号码
@@ -70,12 +153,12 @@
    *
    */
   function isMobile(value) {
-    const valueStr = convertToString(value);
-    return reg$c.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$d.test(valueStr);
   }
 
   // 固定电话 支持区号和分机号 3～4位区号，以0开头；7～8位直播号，以2～9开头；1～6位分机号
-  const reg$b = /^(0\d{2,3}\-)?([2-9]\d{6,7})(\-\d{1,6})?$/;
+  const reg$c = /^(0\d{2,3}\-)?([2-9]\d{6,7})(\-\d{1,6})?$/;
 
   /**
    * 检测值是否为固定电话
@@ -101,12 +184,12 @@
    *
    */
   function isTelephone(value) {
-    const valueStr = convertToString(value);
-    return reg$b.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$c.test(valueStr);
   }
 
   // 邮政编码
-  const reg$a = /^\d{6}$/;
+  const reg$b = /^\d{6}$/;
 
   /**
    * 检测值是否为邮政编码，6位数字
@@ -126,8 +209,8 @@
    *
    */
   function isPostcode(value) {
-    const valueStr = convertToString(value);
-    return reg$a.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$b.test(valueStr);
   }
 
   // 身份证号正则
@@ -185,7 +268,7 @@
    *
    */
   function isIdCard(value, { loose = false, checkCode = true } = {}) {
-    const valueStr = convertToString(value);
+    const valueStr = normalizeString(value);
     if (valueStr.length === 15 && loose) {
       return regIdCard$1.test(valueStr);
     }
@@ -201,7 +284,7 @@
   }
 
   // 邮箱
-  const reg$9 = /^[\da-z]+([\-\.\_]?[\da-z]+)*@[\da-z]+([\-\.]?[\da-z]+)*(\.[a-z]{2,})+$/i;
+  const reg$a = /^[\da-z]+([\-\.\_]?[\da-z]+)*@[\da-z]+([\-\.]?[\da-z]+)*(\.[a-z]{2,})+$/i;
 
   /**
    * 检测值是否为Email
@@ -221,12 +304,12 @@
    *
    */
   function isEmail(value) {
-    const valueStr = convertToString(value);
-    return reg$9.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$a.test(valueStr);
   }
 
   // QQ号正则
-  const reg$8 = /^[1-9]\d{4,10}$/;
+  const reg$9 = /^[1-9]\d{4,10}$/;
 
   /**
    * 检测值是否为QQ号，非0开头，5至11位数字
@@ -246,12 +329,12 @@
    *
    */
   function isQQ(value) {
-    const valueStr = convertToString(value);
-    return reg$8.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$9.test(valueStr);
   }
 
   // 微信号 6至20位，以字母开头，字母，数字，减号（连接符），下划线
-  const reg$7 = /^[a-z]([-_a-z0-9]{5,19})+$/i;
+  const reg$8 = /^[a-z]([-_a-z0-9]{5,19})+$/i;
 
   /**
    * 检测值是否为微信号
@@ -271,12 +354,12 @@
    *
    */
   function isWX(value) {
-    const valueStr = convertToString(value);
-    return reg$7.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$8.test(valueStr);
   }
 
   // 车牌号正则
-  const reg$6 = /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}(([A-Z0-9]{4}[A-Z0-9挂学警港澳]{1})|([A-Z0-9]{5}[DF])|([DF][A-Z0-9]{5}))$/;
+  const reg$7 = /^[京津沪渝冀豫云辽黑湘皖鲁新苏浙赣鄂桂甘晋蒙陕吉闽贵粤青藏川宁琼使领A-Z]{1}[A-Z]{1}(([A-Z0-9]{4}[A-Z0-9挂学警港澳]{1})|([A-Z0-9]{5}[DF])|([DF][A-Z0-9]{5}))$/;
 
   /**
    * 检测值是否为车牌号，支持新能源和非新能源车牌
@@ -306,24 +389,24 @@
    *
    */
   function isVehicle(value) {
-    const valueStr = convertToString(value);
-    return reg$6.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$7.test(valueStr);
   }
 
   // 非0开头，10~21位数字
-  const reg$5 = /^[1-9]\d{9,20}$/;
+  const reg$6 = /^[1-9]\d{9,20}$/;
 
   // 8~30位数字
   const regLoose = /^\d{8,30}$/;
 
   /**
    * luhn 计算校验位
-   *
-   * @param {string} num 银行卡前面数字
-   * @returns
+   * @private
+   * @param {string} numStr 银行卡前面数字
+   * @returns {number}
    */
-  function sumCheckCode$2(num) {
-    const numArr = (num + '').replace(/\D/g, '').split('').reverse();
+  function sumCheckCode$2(numStr) {
+    const numArr = (numStr + '').replace(/\D/g, '').split('').reverse();
 
     let sum = 0;
     for (let i = 0; i < numArr.length; i++) {
@@ -362,8 +445,8 @@
    *
    */
   function isBankCard(value, { loose = false, luhn = false } = {}) {
-    const valueStr = convertToString(value);
-    const validateResult = loose ? regLoose.test(valueStr) : reg$5.test(valueStr);
+    const valueStr = normalizeString(value);
+    const validateResult = loose ? regLoose.test(valueStr) : reg$6.test(valueStr);
 
     if (validateResult && luhn) {
       const precode = valueStr.substring(0, valueStr.length - 1);
@@ -433,7 +516,7 @@
    *
    */
   function isSocialCreditCode(value, { loose = false } = {}) {
-    const valueStr = convertToString(value);
+    const valueStr = normalizeString(value);
 
     const passBaseRule = baseReg$1.test(valueStr);
 
@@ -771,7 +854,7 @@
   }
 
   // 护照号 9位，包括首字母和数字；支持 普通护照(E*)、外交护照(DE)、公务护照(SE)、公务普通护照(PE)、香港特区护照(K/KJ)、澳门特区护照(MA)
-  const reg$4 = /^((e[\da-z])|(de)|(se)|(pe)|(k[\da-z])|(kj)|(ma))[\da-z]{7}$/i;
+  const reg$5 = /^((e[\da-z])|(de)|(se)|(pe)|(k[\da-z])|(kj)|(ma))[\da-z]{7}$/i;
 
   /**
    * 检测值是否为护照号
@@ -793,8 +876,8 @@
    *
    */
   function isPassport(value) {
-    const valueStr = convertToString(value);
-    return reg$4.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$5.test(valueStr);
   }
 
   const chineseDictionary = {
@@ -863,13 +946,13 @@
    *
    */
   function isChinese(value, { loose = false } = {}) {
-    const valueStr = convertToString(value);
+    const valueStr = normalizeString(value);
     const reg = new RegExp(loose ? looseChineseRegExp : chineseRegExp, supportRegExpUnicode ? 'u' : undefined);
     return reg.test(valueStr);
   }
 
   // ipv4正则
-  const reg$3 = /^((\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.){3}(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])$/;
+  const reg$4 = /^((\d{1,2}|1\d\d|2[0-4]\d|25[0-5])\.){3}(\d{1,2}|1\d\d|2[0-4]\d|25[0-5])$/;
 
   /**
    * 检测值是否为ipv4
@@ -895,12 +978,12 @@
    *
    */
   function isIPv4(value) {
-    const valueStr = convertToString(value);
-    return reg$3.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$4.test(valueStr);
   }
 
   // ipv6正则
-  const reg$2 = /^((([0-9A-F]{1,4}:){7}([0-9A-F]{1,4}|:))|(([0-9A-F]{1,4}:){6}(:[0-9A-F]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3})|:))|(([0-9A-F]{1,4}:){5}(((:[0-9A-F]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3})|:))|(([0-9A-F]{1,4}:){4}(((:[0-9A-F]{1,4}){1,3})|((:[0-9A-F]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(([0-9A-F]{1,4}:){3}(((:[0-9A-F]{1,4}){1,4})|((:[0-9A-F]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(([0-9A-F]{1,4}:){2}(((:[0-9A-F]{1,4}){1,5})|((:[0-9A-F]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(([0-9A-F]{1,4}:){1}(((:[0-9A-F]{1,4}){1,6})|((:[0-9A-F]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(:(((:[0-9A-F]{1,4}){1,7})|((:[0-9A-F]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:)))(%.+)?$/i;
+  const reg$3 = /^((([0-9A-F]{1,4}:){7}([0-9A-F]{1,4}|:))|(([0-9A-F]{1,4}:){6}(:[0-9A-F]{1,4}|((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3})|:))|(([0-9A-F]{1,4}:){5}(((:[0-9A-F]{1,4}){1,2})|:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3})|:))|(([0-9A-F]{1,4}:){4}(((:[0-9A-F]{1,4}){1,3})|((:[0-9A-F]{1,4})?:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(([0-9A-F]{1,4}:){3}(((:[0-9A-F]{1,4}){1,4})|((:[0-9A-F]{1,4}){0,2}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(([0-9A-F]{1,4}:){2}(((:[0-9A-F]{1,4}){1,5})|((:[0-9A-F]{1,4}){0,3}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(([0-9A-F]{1,4}:){1}(((:[0-9A-F]{1,4}){1,6})|((:[0-9A-F]{1,4}){0,4}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:))|(:(((:[0-9A-F]{1,4}){1,7})|((:[0-9A-F]{1,4}){0,5}:((25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(\.(25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3}))|:)))(%.+)?$/i;
 
   /**
    * 检测值是否为ipv6
@@ -951,12 +1034,12 @@
    *
    */
   function isIPv6(value) {
-    const valueStr = convertToString(value);
-    return reg$2.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$3.test(valueStr);
   }
 
   // url正则
-  const reg$1 = /(((^https?:(?:\/\/)?)(?:[-;:&=\+\$,\w]+@)?[A-Za-z0-9.-]+(?::\d+)?|(?:www.|[-;:&=\+\$,\w]+@)[A-Za-z0-9.-]+)((?:\/[\+~%\/.\w-_]*)?\??(?:[-\+=&;%@.\w_]*)#?(?:[\w]*))?)$/;
+  const reg$2 = /(((^https?:(?:\/\/)?)(?:[-;:&=\+\$,\w]+@)?[A-Za-z0-9.-]+(?::\d+)?|(?:www.|[-;:&=\+\$,\w]+@)[A-Za-z0-9.-]+)((?:\/[\+~%\/.\w-_]*)?\??(?:[-\*\+=&;%@.\w_]*)#?(?:[\w]*))?)$/;
 
   /**
    * 检测值是否为url
@@ -991,8 +1074,8 @@
    * // => true
    */
   function isUrl(value) {
-    const valueStr = convertToString(value);
-    return reg$1.test(valueStr);
+    const valueStr = normalizeString(value);
+    return reg$2.test(valueStr);
   }
 
   // 基础规则，由14位数字本体码和1位数字校验码组成，其中本体码从左至右依次为：6位首次登记机关码、8位顺序码。
@@ -1058,7 +1141,7 @@
    * // => true
    */
   function isBusinessLicense(value, { loose = false } = {}) {
-    const valueStr = convertToString(value);
+    const valueStr = normalizeString(value);
 
     const passBaseRule = baseReg.test(valueStr);
 
@@ -1126,7 +1209,7 @@
    * isHMCard('M32031177') // true
    */
   function isHMCard(value) {
-    const valueStr = convertToString(value);
+    const valueStr = normalizeString(value);
     return regHMCard.test(valueStr);
   }
 
@@ -1150,10 +1233,37 @@
    * isTWCard('F290299977') // true
    */
   function isTWCard(value) {
-    const valueStr = convertToString(value);
+    const valueStr = normalizeString(value);
     return regTWCard.test(valueStr);
   }
 
+  const reg$1 = /^[A-Z]{6}[A-Z\d]{2}(?:[A-Z\d]{3})?$/;
+
+  /**
+   * 检测值是否为 Swift Code。8位或11位，前6位为大写字母，7-8位为大写字母或数字，9-11位为可选的大写字母或数字。
+   *
+   * @static
+   * @alias module:Validator.isSwiftCode
+   * @see 参考 {@link https://zh.wikipedia.org/wiki/ISO_9362|ISO 9362}
+   * @since 4.9.0
+   * @param {*} value 要检测的值
+   * @returns {boolean} 值是否为 Swift Code
+   * @example
+   *
+   * isSwiftCode('DEUTDEFF') //  true
+   * isSwiftCode('deutdeff') //  false
+   *
+   * isSwiftCode('BKTWTWTP010') //  true
+   * isSwiftCode('010BKTWTWTP') //  false
+   *
+   * isSwiftCode('ICBKCNBJBJM') //  true
+   *
+   */
+  function isSwiftCode(value) {
+    const valueStr = normalizeString(value);
+    return reg$1.test(valueStr);
+  }
+
   // 最大安全数字
   const MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
   // 最小安全数字
@@ -1455,89 +1565,6 @@
     return symbol + formatInt(intStr, thousand) + formatDec(decStr, precision, decimal);
   };
 
-  /**
-   * 检查值是否为Undefined
-   *
-   * @static
-   * @alias module:Type.isUndefined
-   * @since 1.1.0
-   * @param {*} value 检查值
-   * @returns {boolean} 是否为Undefined
-   * @example
-   *
-   * isUndefined(undefined)
-   * // => true
-   *
-   * isUndefined(void 0)
-   * // => true
-   *
-   * isUndefined(null)
-   * // => false
-   */
-  function isUndefined(value) {
-    return value === void 0;
-  }
-
-  /**
-   * 检查值是否为Null
-   *
-   * @static
-   * @alias module:Type.isNull
-   * @since 1.1.0
-   * @param {*} value 检查值
-   * @returns {boolean} 是否为Null
-   * @example
-   *
-   * isNull(null)
-   * // => true
-   *
-   * isNull(void 0)
-   * // => false
-   */
-  function isNull(value) {
-    return value === null;
-  }
-
-  /**
-   * 检查值是否为 undefined 或 null
-   *
-   * @static
-   * @alias module:Type.isNaN
-   * @since 4.3.0
-   * @param {*} value 检查值
-   * @returns {boolean} 是否为 undefined 或 null
-   */
-  function isNil(value) {
-    return isUndefined(value) || isNull(value);
-  }
-
-  /**
-   * 规整化字符串。如果值为 undefined 或 null 将转为空字符串，如果值不是字符串类型将转为字符串。
-   *
-   * @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
-   * @param {*} value 待处理的值
-   * @returns {string} 规整化的值
-   * @example
-   * normalizeString(); // ''
-   * normalizeString(undefined); // ''
-   * normalizeString(void 0); // ''
-   * normalizeString(null); // ''
-   *
-   * normalizeString(true); // 'true'
-   * normalizeString(NaN); // 'NaN'
-   * normalizeString(1); // '1'
-   * normalizeString('a'); // 'a'
-   */
-  function normalizeString(value) {
-    if (isNil(value)) {
-      return '';
-    }
-    return convertToString(value);
-  }
-
   /**
    * 格式化银行卡号
    *
@@ -2620,7 +2647,7 @@
    * @alias module:Other.randomString
    * @since 4.8.0
    * @param {number} [len=0] 长度
-   * @param {string} [optionalChars] 允许的字符，默认为数字和大小写字母
+   * @param {string} [optionalChars='0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'] 允许的字符，默认为数字和大小写字母
    * @returns {string} 随机字符串
    * @example
    * randomString(5); // slk23
@@ -2637,6 +2664,38 @@
     return internalRandomString(len, realChars);
   }
 
+  /**
+   * 获取字符长度。中文汉字占2个字符，英文占1个字符，特殊如emoji占4个字符。
+   *
+   * @static
+   * @alias module:Other.strlen
+   * @since 4.10.0
+   * @param {string} str 字符串
+   * @returns {number} 字符长度
+   * @example
+   *
+   * strlen('你好a'); // 5
+   * strlen('你好，世界！'); // 12
+   * strlen('严両丞丽'); // 8
+   * strlen('abcde'); // 5
+   * strlen('𠮷'); // 4
+   * strlen('🍎'); // 4
+   *
+   */
+  function strlen(str) {
+    const realStr = normalizeString(str);
+    let len = 0;
+    for (let i = 0; i < realStr.length; i++) {
+      const c = realStr.charCodeAt(i);
+      if ((c >= 0x0001 && c <= 0x007e) || (0xff60 <= c && c <= 0xff9f)) {
+        len++;
+      } else {
+        len += 2;
+      }
+    }
+    return len;
+  }
+
   exports.blobToDataURL = blobToDataURL;
   exports.bytesToSize = bytesToSize;
   exports.calculateCursorPosition = calculateCursorPosition;
@@ -2660,6 +2719,7 @@
   exports.isPromiseLike = isPromiseLike;
   exports.isQQ = isQQ;
   exports.isSocialCreditCode = isSocialCreditCode;
+  exports.isSwiftCode = isSwiftCode;
   exports.isTWCard = isTWCard;
   exports.isTelephone = isTelephone;
   exports.isUrl = isUrl;
@@ -2677,6 +2737,7 @@
   exports.safeDate = safeDate;
   exports.setDataURLPrefix = setDataURLPrefix;
   exports.setDisableWarning = setDisableWarning;
+  exports.strlen = strlen;
   exports.times = times;
   exports.validatePassword = validatePassword;
   exports.waitTime = waitTime;