util-helpers 4.7.1 → 4.8.1

package/README.md

@@ -81,6 +81,7 @@ formatMoney('1000'); // => 1,000.00
   - [validatePassword](https://doly-dev.github.io/util-helpers/module-Validator.html#.validatePassword) - 验证密码
 - 其他
   - [calculateCursorPosition](https://doly-dev.github.io/util-helpers/module-Other.html#.calculateCursorPosition) - 计算光标位置
+  - [randomString](https://doly-dev.github.io/util-helpers/module-Other.html#.randomString) - 随机字符串
   - [waitTime](https://doly-dev.github.io/util-helpers/module-Other.html#.waitTime) - 等待时间返回 Promise
 
 ## 精选第三方工具库

package/dist/util-helpers.js

@@ -151,7 +151,7 @@
     if (num < 10) {
       return num === Number(id[17]);
     } else {
-      return id[17] == 'X';
+      return id[17].toUpperCase() === 'X';
     }
   }
 
@@ -316,6 +316,24 @@
   // 8~30位数字
   const regLoose = /^\d{8,30}$/;
 
+  /**
+   * luhn 计算校验位
+   *
+   * @param {string} num 银行卡前面数字
+   * @returns
+   */
+  function sumCheckCode$2(num) {
+    const numArr = (num + '').replace(/\D/g, '').split('').reverse();
+
+    let sum = 0;
+    for (let i = 0; i < numArr.length; i++) {
+      const currNum = parseInt(numArr[i]);
+      sum += i % 2 === 0 ? currNum * 2 - (currNum > 4 ? 9 : 0) : currNum;
+    }
+    const mod = sum % 10;
+    return mod !== 0 ? 10 - mod : 0;
+  }
+
   /**
    * 检测值是否为银行卡号。正常模式（非0开头，10~21位数字）宽松模式（8~30位数字）
    *
@@ -326,6 +344,7 @@
    * @param {*} value 要检测的值
    * @param {Object} [options] 配置项
    * @param {boolean} [options.loose=false] 宽松模式，8~30位数字
+   * @param {boolean} [options.luhn=false] 使用 Luhn 算法校验校验码
    * @returns {boolean} 值是否为银行卡号
    * @example
    *
@@ -342,13 +361,16 @@
    * // => true
    *
    */
-  function isBankCard(value, { loose = false } = {}) {
+  function isBankCard(value, { loose = false, luhn = false } = {}) {
     const valueStr = convertToString(value);
+    const validateResult = loose ? regLoose.test(valueStr) : reg$5.test(valueStr);
 
-    if (loose) {
-      return regLoose.test(valueStr);
+    if (validateResult && luhn) {
+      const precode = valueStr.substring(0, valueStr.length - 1);
+      const checkCode = valueStr[valueStr.length - 1];
+      return checkCode === String(sumCheckCode$2(precode));
     }
-    return reg$5.test(valueStr);
+    return validateResult;
   }
 
   // 基础规则，由18位数字和大写字母组成，不使用I、O、Z、S、V。
@@ -357,31 +379,6 @@
   // 基础字符组成
   const baseCodeArr = '0123456789ABCDEFGHJKLMNPQRTUWXY'.split('');
 
-  //加权因子
-  const weightFactor = [1, 3, 9, 27, 19, 26, 16, 17, 20, 29, 25, 13, 8, 24, 10, 30, 28];
-
-  /**
-   * 获取字符位置
-   *
-   * @private
-   * @param {string} code 字符
-   * @returns {number} 字符所在基础字符的位置
-   */
-  function getBaseCodeIndex(code) {
-    let ret;
-
-    baseCodeArr.some((item, index) => {
-      if (item === code) {
-        ret = index;
-        return true;
-      }
-      return false;
-    });
-
-    // @ts-ignore
-    return ret;
-  }
-
   /**
    * 计算校验码
    *
@@ -391,16 +388,14 @@
    * @returns {string} 校验码
    */
   function sumCheckCode$1(preCode) {
-    // const preCodeArr = preCode.split('');
-
     let total = 0;
 
     // 计算字符位置对应序号和加权因子的乘积，总和
     for (let i = 0; i < 17; i++) {
       // 字符位置对应的基础编码序号
-      const index = getBaseCodeIndex(preCode[i]);
+      const index = baseCodeArr.findIndex((item) => item === preCode[i]);
       // 加权因子
-      const wf = weightFactor[i];
+      const wf = Math.pow(3, i) % 31;
       // 计算序号和加权因子的乘积，并计算级数之和
       total += index * wf;
     }
@@ -2599,6 +2594,49 @@
     return pos;
   }
 
+  const numberChars = '0123456789';
+  const letterChars = 'abcdefghijklmnopqrstuvwxyz';
+  const defaultChars = numberChars + letterChars + letterChars.toUpperCase();
+
+  /**
+   * @private
+   * @param {number} [len=0] 长度
+   * @param {string} [optionalChars] 允许的字符，默认为数字和大小写字母
+   * @param {string} [prefix=''] 前缀部分，不计入长度
+   * @returns {string}
+   */
+  function internalRandomString(len = 0, optionalChars = defaultChars, prefix = '') {
+    while (len-- > 0) {
+      const r = optionalChars[Math.floor(Math.random() * optionalChars.length)];
+      return internalRandomString(len, optionalChars, prefix + r);
+    }
+    return prefix;
+  }
+
+  /**
+   * 生成随机字符串
+   *
+   * @static
+   * @alias module:Other.randomString
+   * @since 4.8.0
+   * @param {number} [len=0] 长度
+   * @param {string} [optionalChars] 允许的字符，默认为数字和大小写字母
+   * @returns {string} 随机字符串
+   * @example
+   * randomString(5); // slk23
+   * randomString(8); // 71mHqo2A
+   *
+   * // 自定义允许的字符
+   * randomString(5, 'abc'); // ccbcb
+   * randomString(8, 'abcefg'); // bcgcfabg
+   */
+  function randomString(len = 0, optionalChars) {
+
+    const realChars = typeof optionalChars === 'string' && optionalChars ? optionalChars : defaultChars;
+
+    return internalRandomString(len, realChars);
+  }
+
   exports.blobToDataURL = blobToDataURL;
   exports.bytesToSize = bytesToSize;
   exports.calculateCursorPosition = calculateCursorPosition;
@@ -2633,6 +2671,7 @@
   exports.padZero = padZero;
   exports.parseIdCard = parseIdCard;
   exports.plus = plus;
+  exports.randomString = randomString;
   exports.replaceChar = replaceChar;
   exports.round = round;
   exports.safeDate = safeDate;