util-helpers 4.8.1 → 4.9.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) 是一个基于业务场景的工具方法库。
 

package/dist/util-helpers.js

@@ -50,7 +50,7 @@
   }
 
   // 手机号码 11位数字，以1开头，第二位是3456789其中一个，后面再加9个数字
-  const reg$c = /^1[3456789]\d{9}$/;
+  const reg$d = /^1[3456789]\d{9}$/;
 
   /**
    * 检测值是否为手机号码
@@ -71,11 +71,11 @@
    */
   function isMobile(value) {
     const valueStr = convertToString(value);
-    return reg$c.test(valueStr);
+    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})?$/;
 
   /**
    * 检测值是否为固定电话
@@ -102,11 +102,11 @@
    */
   function isTelephone(value) {
     const valueStr = convertToString(value);
-    return reg$b.test(valueStr);
+    return reg$c.test(valueStr);
   }
 
   // 邮政编码
-  const reg$a = /^\d{6}$/;
+  const reg$b = /^\d{6}$/;
 
   /**
    * 检测值是否为邮政编码，6位数字
@@ -127,7 +127,7 @@
    */
   function isPostcode(value) {
     const valueStr = convertToString(value);
-    return reg$a.test(valueStr);
+    return reg$b.test(valueStr);
   }
 
   // 身份证号正则
@@ -201,7 +201,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
@@ -222,11 +222,11 @@
    */
   function isEmail(value) {
     const valueStr = convertToString(value);
-    return reg$9.test(valueStr);
+    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位数字
@@ -247,11 +247,11 @@
    */
   function isQQ(value) {
     const valueStr = convertToString(value);
-    return reg$8.test(valueStr);
+    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;
 
   /**
    * 检测值是否为微信号
@@ -272,11 +272,11 @@
    */
   function isWX(value) {
     const valueStr = convertToString(value);
-    return reg$7.test(valueStr);
+    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}))$/;
 
   /**
    * 检测值是否为车牌号，支持新能源和非新能源车牌
@@ -307,23 +307,23 @@
    */
   function isVehicle(value) {
     const valueStr = convertToString(value);
-    return reg$6.test(valueStr);
+    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++) {
@@ -363,7 +363,7 @@
    */
   function isBankCard(value, { loose = false, luhn = false } = {}) {
     const valueStr = convertToString(value);
-    const validateResult = loose ? regLoose.test(valueStr) : reg$5.test(valueStr);
+    const validateResult = loose ? regLoose.test(valueStr) : reg$6.test(valueStr);
 
     if (validateResult && luhn) {
       const precode = valueStr.substring(0, valueStr.length - 1);
@@ -403,7 +403,7 @@
     // 计算整数求余函数MOD
     const remainder = total % 31;
     // 校验码字符值序号
-    const checkCodeIndex = 31 - remainder;
+    const checkCodeIndex = remainder !== 0 ? 31 - remainder : 0;
 
     return baseCodeArr[checkCodeIndex];
   }
@@ -771,7 +771,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;
 
   /**
    * 检测值是否为护照号
@@ -794,7 +794,7 @@
    */
   function isPassport(value) {
     const valueStr = convertToString(value);
-    return reg$4.test(valueStr);
+    return reg$5.test(valueStr);
   }
 
   const chineseDictionary = {
@@ -869,7 +869,7 @@
   }
 
   // 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
@@ -896,11 +896,11 @@
    */
   function isIPv4(value) {
     const valueStr = convertToString(value);
-    return reg$3.test(valueStr);
+    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
@@ -952,11 +952,11 @@
    */
   function isIPv6(value) {
     const valueStr = convertToString(value);
-    return reg$2.test(valueStr);
+    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
@@ -992,7 +992,7 @@
    */
   function isUrl(value) {
     const valueStr = convertToString(value);
-    return reg$1.test(valueStr);
+    return reg$2.test(valueStr);
   }
 
   // 基础规则，由14位数字本体码和1位数字校验码组成，其中本体码从左至右依次为：6位首次登记机关码、8位顺序码。
@@ -1154,6 +1154,23 @@
     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
+   */
+  function isSwiftCode(value) {
+    const valueStr = convertToString(value);
+    return reg$1.test(valueStr);
+  }
+
   // 最大安全数字
   const MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER || 9007199254740991;
   // 最小安全数字
@@ -2660,6 +2677,7 @@
   exports.isPromiseLike = isPromiseLike;
   exports.isQQ = isQQ;
   exports.isSocialCreditCode = isSocialCreditCode;
+  exports.isSwiftCode = isSwiftCode;
   exports.isTWCard = isTWCard;
   exports.isTelephone = isTelephone;
   exports.isUrl = isUrl;