util-helpers 4.10.1 → 4.11.0

package/lib/utils/devWarn.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _config = require("./config");
+
+/**
+ * 打印警告信息
+ *
+ * @param  {any[]} args 打印的信息
+ */
+function devWarn() {
+  if (!_config.config.disableWarning) {
+    var _console;
+
+    (_console = console).warn.apply(_console, arguments);
+  }
+}
+
+var _default = devWarn;
+exports["default"] = _default;

package/lib/utils/math.util.js

@@ -13,7 +13,9 @@ exports.scientificToNumber = scientificToNumber;
 
 var _constants = require("./constants");
 
-var _config = require("./config");
+var _devWarn = _interopRequireDefault(require("./devWarn"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 /**
  * 参考: https://github.com/nefe/number-precision/blob/master/src/index.ts
@@ -70,8 +72,10 @@ function digitLength(num) {
 
 
 function float2Fixed(num) {
-  if (!isScientificNumber(num.toString())) {
-    return Number(num.toString().replace('.', ''));
+  var strNum = String(num);
+
+  if (!isScientificNumber(strNum)) {
+    return Number(strNum.replace('.', ''));
   }
 
   var dLen = digitLength(num);
@@ -86,9 +90,7 @@ function float2Fixed(num) {
 
 function checkBoundary(num) {
   if (+num > _constants.MAX_SAFE_INTEGER || +num < _constants.MIN_SAFE_INTEGER) {
-    if (!_config.config.disableWarning) {
-      console.warn("".concat(num, " is beyond boundary when transfer to integer, the results may not be accurate"));
-    }
+    (0, _devWarn["default"])("".concat(num, " is beyond boundary when transfer to integer, the results may not be accurate"));
   }
 }
 /**
@@ -119,40 +121,63 @@ function trimLeftZero(num) {
  *  2.小数点前边是0，小数点后十分位（包含十分位）之后连续零的个数大于等于6个
  *
  * @param {string | number} num 科学计数法数字
- * @returns {string} 转换后的数字字符串
+ * @returns {string | number} 转换后的数字字符串
  */
 
 
 function scientificToNumber(num) {
-  if (isScientificNumber(num.toString())) {
-    var zero = '0';
-    var parts = String(num).toLowerCase().split('e');
-    var e = parts.pop(); // 存储指数
-    // @ts-ignore
+  var strNum = String(num);
+
+  if (!isScientificNumber(strNum)) {
+    return num;
+  }
+  /** @type string */
 
-    var l = Math.abs(e); // 取绝对值，l-1就是0的个数
-    // @ts-ignore
 
-    var sign = e / l; //判断正负
+  var ret;
+  var zero = '0';
+  var parts = strNum.toLowerCase().split('e');
+  var e = parts.pop(); // 存储指数
+  // @ts-ignore
 
-    var coeff_array = parts[0].split('.'); // 将系数按照小数点拆分
-    //如果是小数
+  var l = Math.abs(e); // 取绝对值，l-1就是0的个数
+  // @ts-ignore
 
-    if (sign === -1) {
-      //拼接字符串，如果是小数，拼接0和小数点
-      num = zero + '.' + new Array(l).join(zero) + coeff_array.join('');
-    } else {
-      var dec = coeff_array[1]; //如果是整数，将整数除第一位之外的非零数字计入位数，相应的减少0的个数
+  var sign = e / l; //判断正负
+
+  var coeff_array = parts[0].split('.'); // 将系数按照小数点拆分
+  // 如果是小数
+
+  if (sign === -1) {
+    // 整数部分
+    var intVal = trimLeftZero(coeff_array[0]); // 整数部分大于科学计数后面部分
+    // 如: 10e-1, 10.2e-1
 
-      if (l - dec.length < 0) {
-        num = trimLeftZero(coeff_array[0] + dec.substring(0, l)) + '.' + dec.substring(l);
-      } else {
-        //拼接字符串，如果是整数，不需要拼接小数点
-        num = coeff_array.join('') + new Array(l - dec.length + 1).join(zero);
+    if (intVal.length > l) {
+      var thanLen = intVal.length - l;
+      var dec = coeff_array[1] || '';
+      ret = intVal.slice(0, thanLen); // 处理 10e-1, 100e-1
+
+      if (intVal.slice(thanLen) !== '0' || dec) {
+        ret += '.' + intVal.slice(thanLen) + dec;
       }
+    } else {
+      // 整数部分小于等于科学计数后面部分
+      // 如: 1e-1, 0.2e-1, 1.2e-2, 1.2e-1
+      ret = zero + '.' + new Array(l - intVal.length + 1).join(zero) + coeff_array.join('');
     }
-  } // @ts-ignore
+  } else {
+    // 小数部分
+    var _dec = coeff_array[1] || ''; // 如果是整数，将整数除第一位之外的非零数字计入位数，相应的减少0的个数
 
 
-  return num;
+    if (l - _dec.length < 0) {
+      ret = trimLeftZero(coeff_array[0] + _dec.substring(0, l)) + '.' + _dec.substring(l);
+    } else {
+      // 拼接字符串，如果是整数，不需要拼接小数点
+      ret = coeff_array.join('') + new Array(l - _dec.length + 1).join(zero);
+    }
+  }
+
+  return trimLeftZero(ret);
 }

package/lib/validatePassword.js

@@ -5,7 +5,9 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
-var _config = require("./utils/config");
+var _devWarn = _interopRequireDefault(require("./utils/devWarn"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 var regNumber = /[\d]/;
 var regLowerCaseLetter = /[a-z]/;
@@ -63,19 +65,22 @@ function hasHex(val) {
  *
  * @private
  * @param {string} val 检测的值
- * @param {string} [chars] 特殊字符
+ * @param {string} chars 特殊字符
  * @returns {boolean} 是否包含特殊字符
  */
 
 
-function hasSpecialCharacter(val) {
-  var chars = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
-
-  if (!chars) {
+function hasSpecialCharacter(val, chars) {
+  if (!chars || !val) {
     return false;
   }
 
   var specialChars = val.replace(regAllNumberAndLetter, '');
+
+  if (!specialChars) {
+    return false;
+  }
+
   var regChars = hasHex(chars) ? new RegExp("[".concat(chars, "]")) : null;
 
   if (regChars) {
@@ -97,16 +102,21 @@ function hasSpecialCharacter(val) {
  *
  * @private
  * @param {string} val 检测的值
- * @param {string} chars 非法字符
+ * @param {string} chars 特殊字符
  * @returns {boolean} 是否包含非法字符
  */
 
 
-function hasUnallowableCharacter(val) {
-  var chars = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+function hasUnallowableCharacter(val, chars) {
+  if (!val) {
+    return false;
+  }
+
   var specialChars = val.replace(regAllNumberAndLetter, '');
 
-  if (!chars && specialChars) {
+  if (!specialChars) {
+    return false;
+  } else if (!chars) {
     return true;
   }
 
@@ -171,7 +181,7 @@ function hasUnallowableCharacter(val) {
  *   }
  * }
  *
- * validatePassword('a12345678', {level: 3});
+ * validatePassword('a12345678', { level: 3 });
  * // =>
  * {
  *   validated: false,
@@ -185,7 +195,7 @@ function hasUnallowableCharacter(val) {
  *   }
  * }
  *
- * validatePassword('_Aa一二三45678', {level: 3, ignoreCase: true});
+ * validatePassword('_Aa一二三45678', { level: 3, ignoreCase: true });
  * // =>
  * {
  *   validated: false,
@@ -200,7 +210,7 @@ function hasUnallowableCharacter(val) {
  * }
  *
  * // 自定义特殊字符
- * validatePassword('_Aa一二三45678', {level: 3, ignoreCase: true, special: '_一二三'});
+ * validatePassword('_Aa一二三45678', { level: 3, ignoreCase: true, special: '_一二三' });
  * // =>
  * {
  *   validated: true,
@@ -228,10 +238,7 @@ function validatePassword(value) {
   var valStr = value;
 
   if (typeof value !== 'string') {
-    if (!_config.config.disableWarning) {
-      console.warn("[validatePassword] value must be a string.");
-    }
-
+    (0, _devWarn["default"])("[validatePassword] value must be a string.");
     valStr = '';
   }
 
@@ -243,16 +250,16 @@ function validatePassword(value) {
 
   var containesUpperCaseLetter = hasUpperCaseLetter(valStr); // 包含特殊字符
 
-  var containesSpecialCharacter = hasSpecialCharacter(valStr, special); // 包含非法字符
+  var containesSpecialCharacter = hasSpecialCharacter(valStr, special); // 包含非法字符，即含有非数字字母特殊字符以外的其他字符
 
   var containesUnallowableCharacter = hasUnallowableCharacter(valStr, special);
 
   if (containesNumber) {
     currentLevel += 1;
-  }
+  } // 不区分大小写
+
 
   if (ignoreCase) {
-    // 不区分大小写
     if (containesLowerCaseLetter || containesUpperCaseLetter) {
       currentLevel += 1;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.10.1",
+  "version": "4.11.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -8,11 +8,12 @@
   "types": "types/index.d.ts",
   "scripts": {
     "test": "jest --verbose",
+    "test:coverage": "jest --coverage",
     "test:math": "jest --verbose test/math",
     "test:type": "jest --verbose test/type",
     "test:validator": "jest --verbose test/validator",
     "test:processor": "jest --verbose test/processor",
-    "build": "npm test && npm run build:lib && npm run build:esm && npm run build:dist && npm run types",
+    "build": "npm run build:lib && npm run build:esm && npm run build:dist && npm run types",
     "build:lib": "rm -rf lib && cross-env MODULE_TYPE=cjs babel src --out-dir lib",
     "build:esm": "rm -rf esm && cross-env MODULE_TYPE=esm babel src --out-dir esm",
     "build:dist": "rm -rf dist && rollup -c",

package/types/isBusinessLicense.d.ts

@@ -8,25 +8,22 @@ export default isBusinessLicense;
  * @since 3.5.0
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
- * @param {boolean} [options.loose=false] 宽松模式。如果为true，不校验校验位。
+ * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。
  * @returns {boolean} 值是否为营业执照号
  * @example
  *
  * isBusinessLicense('310115600985533');
  * // => true
  *
- * isBusinessLicense('3101156009');
- * // => false
- *
- * isBusinessLicense('3101156009', { loose: true });
- * // => false
- *
  * isBusinessLicense('310115600985535');
  * // => false
  *
- * isBusinessLicense('310115600985535', { loose: true });
+ * isBusinessLicense('310115600985535', { checkCode: false });
  * // => true
+ *
+ * isBusinessLicense('31011560098', { checkCode: false });
+ * // => false
  */
-declare function isBusinessLicense(value: any, { loose }?: {
-    loose?: boolean | undefined;
+declare function isBusinessLicense(value: any, options?: {
+    checkCode?: boolean | undefined;
 } | undefined): boolean;

package/types/isChinese.d.ts

@@ -9,6 +9,7 @@ export default isChinese;
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
  * @param {boolean} [options.loose=false] 宽松模式。如果为true，只要包含中文即为true
+ * @param {boolean} [options.useExtend=false] 使用统一表意文字扩展A-F。注意：如果不支持 `RegExp.prototype.unicode`，扩展字符集将自动不生效，如IE浏览器。
  * @returns {boolean} 值是否为中文
  * @example
  *
@@ -19,13 +20,22 @@ export default isChinese;
  * // => false
  *
  * // 宽松模式，只要包含中文即为true
- * isChinese('林A', {loose: true});
+ * isChinese('林A', { loose: true });
  * // => true
  *
- * isChinese('A林A', {loose: true});
+ * isChinese('A林A', { loose: true });
  * // => true
  *
+ * isChinese('𠮷');
+ * // => false
+ *
+ * // 使用中文扩展字符集，需要浏览器支持 RegExp.prototype.unicode 才生效。
+ * isChinese('𠮷', { useExtend: true });
+ * // => true
+ * isChinese('𠮷aa', { useExtend: true, loose: true });
+ * // => true
  */
-declare function isChinese(value: any, { loose }?: {
+declare function isChinese(value: any, { loose, useExtend }?: {
     loose?: boolean | undefined;
+    useExtend?: boolean | undefined;
 } | undefined): boolean;

package/types/isSocialCreditCode.d.ts

@@ -8,7 +8,7 @@ export default isSocialCreditCode;
  * @since 1.1.0
  * @param {*} value 要检测的值
  * @param {Object} [options] 配置项
- * @param {boolean} [options.loose=false] 宽松模式。如果为true，不校验校验位。
+ * @param {boolean} [options.checkCode=true] 是否校验最后一位校验码，如果为false，不校验校验位。
  * @returns {boolean} 值是否为统一社会信用代码
  * @example
  *
@@ -18,11 +18,14 @@ export default isSocialCreditCode;
  * isSocialCreditCode('91350100M000100Y4A');
  * // => false
  *
- * // 宽松模式，不校验校验位。所以也可以通过
- * isSocialCreditCode('91350100M000100Y4A', {loose: true});
+ * // 不校验校验位
+ * isSocialCreditCode('91350100M000100Y4A', { checkCode: false });
  * // => true
  *
+ * isSocialCreditCode('91350100M000100Y', { checkCode: false });
+ * // => false
+ *
  */
-declare function isSocialCreditCode(value: any, { loose }?: {
-    loose?: boolean | undefined;
+declare function isSocialCreditCode(value: any, options?: {
+    checkCode?: boolean | undefined;
 } | undefined): boolean;

package/types/isTWCard.d.ts

@@ -7,12 +7,17 @@ export default isTWCard;
  * @since 4.0.0
  * @see 参考 {@link https://zh.wikipedia.org/wiki/台湾居民来往大陆通行证|台湾居民来往大陆通行证}
  * @param {*} value 要检测的值
+ * @param {Object} [options] 配置项
+ * @param {boolean} [options.loose=false] 宽松模式。如果为true，表示支持一次性短期通行证
  * @returns {boolean} 是否为台湾居民来往大陆通行证
  * @example
  * isTWCard('12345678') // true
  * isTWCard('07257456') // true
  *
  * // 一次性短期
- * isTWCard('F290299977') // true
+ * isTWCard('F290299977') // false
+ * isTWCard('F290299977', { loose: true }) // true
  */
-declare function isTWCard(value: any): boolean;
+declare function isTWCard(value: any, { loose }?: {
+    loose?: boolean | undefined;
+} | undefined): boolean;

package/types/replaceChar.d.ts

@@ -45,7 +45,7 @@ export default replaceChar;
  * // => 林**
  *
  */
-declare function replaceChar(str?: string, { start, end, char, repeat, exclude }?: {
+declare function replaceChar(str: string, { start, end, char, repeat, exclude }?: {
     start?: number | undefined;
     end?: number | undefined;
     char?: string | undefined;

package/types/utils/devWarn.d.ts

@@ -0,0 +1,7 @@
+export default devWarn;
+/**
+ * 打印警告信息
+ *
+ * @param  {any[]} args 打印的信息
+ */
+declare function devWarn(...args: any[]): void;

package/types/utils/math.util.d.ts

@@ -51,6 +51,6 @@ export function trimLeftZero(num: string): string;
  *  2.小数点前边是0，小数点后十分位（包含十分位）之后连续零的个数大于等于6个
  *
  * @param {string | number} num 科学计数法数字
- * @returns {string} 转换后的数字字符串
+ * @returns {string | number} 转换后的数字字符串
  */
-export function scientificToNumber(num: string | number): string;
+export function scientificToNumber(num: string | number): string | number;

package/types/validatePassword.d.ts

@@ -84,7 +84,7 @@ export type ValidatePasswordReturn = {
  *   }
  * }
  *
- * validatePassword('a12345678', {level: 3});
+ * validatePassword('a12345678', { level: 3 });
  * // =>
  * {
  *   validated: false,
@@ -98,7 +98,7 @@ export type ValidatePasswordReturn = {
  *   }
  * }
  *
- * validatePassword('_Aa一二三45678', {level: 3, ignoreCase: true});
+ * validatePassword('_Aa一二三45678', { level: 3, ignoreCase: true });
  * // =>
  * {
  *   validated: false,
@@ -113,7 +113,7 @@ export type ValidatePasswordReturn = {
  * }
  *
  * // 自定义特殊字符
- * validatePassword('_Aa一二三45678', {level: 3, ignoreCase: true, special: '_一二三'});
+ * validatePassword('_Aa一二三45678', { level: 3, ignoreCase: true, special: '_一二三' });
  * // =>
  * {
  *   validated: true,