util-helpers 4.10.3 → 4.12.0

package/lib/plus.js

@@ -9,8 +9,6 @@ var _math = require("./utils/math.util");
 
 var _times = _interopRequireDefault(require("./times"));
 
-var _type = require("./utils/type");
-
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
@@ -55,12 +53,13 @@ function plus() {
 
   if (rest.length > 0) {
     return plus.apply(void 0, [plus(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!(0, _math.isEffectiveNumeric)(num1)) {
+    return (0, _math.isEffectiveNumeric)(num2) ? Number(num2) : NaN;
+  } else if (!(0, _math.isEffectiveNumeric)(num2)) {
+    return Number(num1);
   }
 
   var baseNum = Math.pow(10, Math.max((0, _math.digitLength)(num1), (0, _math.digitLength)(num2)));

package/lib/replaceChar.js

@@ -5,6 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports["default"] = void 0;
 
+var _normalizeString = _interopRequireDefault(require("./normalizeString"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
 /**
  * 替换字符，应用场景如：脱敏
  *
@@ -51,9 +55,7 @@ exports["default"] = void 0;
  * // => 林**
  *
  */
-function replaceChar() {
-  var str = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
-
+function replaceChar(str) {
   var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
       _ref$start = _ref.start,
       start = _ref$start === void 0 ? 3 : _ref$start,
@@ -64,20 +66,21 @@ function replaceChar() {
       repeat = _ref.repeat,
       exclude = _ref.exclude;
 
-  var strLen = str.length; // 开始位置超过str长度
+  var realStr = (0, _normalizeString["default"])(str);
+  var strLen = realStr.length; // 开始位置超过str长度
 
   if (Math.abs(start) >= strLen) {
-    return str;
+    return realStr;
   }
 
   start = start >= 0 ? start : strLen + start;
   end = end >= 0 ? end : strLen + end; // 开始位置大于结束位置
 
   if (start >= end) {
-    return str;
+    return realStr;
   }
 
-  var middleStr = str.substring(start, end);
+  var middleStr = realStr.substring(start, end);
 
   if (exclude) {
     var reg = new RegExp("[^".concat(exclude, "]"), 'g');
@@ -87,7 +90,7 @@ function replaceChar() {
     middleStr = _char.repeat(repeat);
   }
 
-  return str.substring(0, start) + middleStr + str.substring(end);
+  return realStr.substring(0, start) + middleStr + realStr.substring(end);
 }
 
 var _default = replaceChar;

package/lib/round.js

@@ -9,6 +9,8 @@ var _divide = _interopRequireDefault(require("./divide"));
 
 var _times = _interopRequireDefault(require("./times"));
 
+var _math = require("./utils/math.util");
+
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 /**
@@ -33,6 +35,12 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  */
 function round(num) {
   var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+
+  // 兼容处理，如果参数包含无效数值时，返回第一个参数
+  if (!(0, _math.isEffectiveNumeric)(num)) {
+    return NaN;
+  }
+
   var base = Math.pow(10, precision);
   return (0, _divide["default"])(Math.round((0, _times["default"])(num, base)), base);
 }

package/lib/times.js

@@ -7,8 +7,6 @@ exports["default"] = void 0;
 
 var _math = require("./utils/math.util");
 
-var _type = require("./utils/type");
-
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -51,12 +49,13 @@ function times() {
 
   if (rest.length > 0) {
     return times.apply(void 0, [times(num1, num2)].concat(_toConsumableArray(rest)));
-  } // 兼容处理，如果第2个参数为非数字或字符串时，返回第一个参数
+  } // 兼容处理，如果参数包含无效数值时，尝试取出有效数值参数
 
 
-  if ((!(0, _type.isNumber)(num2) || (0, _type.isNaN)(num2)) && !(0, _type.isString)(num2)) {
-    // @ts-ignore
-    return num1;
+  if (!(0, _math.isEffectiveNumeric)(num1)) {
+    return (0, _math.isEffectiveNumeric)(num2) ? Number(num2) : NaN;
+  } else if (!(0, _math.isEffectiveNumeric)(num2)) {
+    return Number(num1);
   }
 
   var num1Changed = (0, _math.float2Fixed)(num1);

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

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.isEffectiveNumeric = isEffectiveNumeric;
 exports.isScientificNumber = isScientificNumber;
 exports.strip = strip;
 exports.digitLength = digitLength;
@@ -13,7 +14,11 @@ exports.scientificToNumber = scientificToNumber;
 
 var _constants = require("./constants");
 
-var _config = require("./config");
+var _devWarn = _interopRequireDefault(require("./devWarn"));
+
+var _type = require("./type");
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
 
 /**
  * 参考: https://github.com/nefe/number-precision/blob/master/src/index.ts
@@ -22,12 +27,42 @@ var _config = require("./config");
  * 问题示例：2.3 + 2.4 = 4.699999999999999，1.0 - 0.9 = 0.09999999999999998
  */
 
+/**
+ * 值是否为有效的数值
+ * 
+ * @param {*} value 待检测的值
+ * @returns {boolean} 是否为有效的数值
+ */
+function isEffectiveNumeric(value) {
+  if ((0, _type.isNumber)(value) && !isNaN(value)) {
+    return true;
+  } // 避免空字符串 或 带空格的字符串
+
+
+  if ((0, _type.isString)(value)) {
+    var fmtStrValue = value.trim(); // 带空格的字符串也不转换数字
+    // Number(' ') => 0
+
+    if (fmtStrValue === value) {
+      var numValue = fmtStrValue ? Number(fmtStrValue) : NaN;
+
+      if ((0, _type.isNumber)(numValue) && !isNaN(numValue)) {
+        return true;
+      }
+    }
+  }
+
+  (0, _devWarn["default"])("".concat(value, " is not a valid number."));
+  return false;
+}
 /**
  * 是否为科学计数法数字
  *
  * @param {string} num 检查值
  * @returns {boolean}
  */
+
+
 function isScientificNumber(num) {
   return /\d+\.?\d*e[\+\-]*\d+/i.test(num);
 }
@@ -70,8 +105,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 +123,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 +154,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);
 
-    var l = Math.abs(e); // 取绝对值，l-1就是0的个数
-    // @ts-ignore
+  if (!isScientificNumber(strNum)) {
+    return num;
+  }
+  /** @type string */
 
-    var sign = e / l; //判断正负
 
-    var coeff_array = parts[0].split('.'); // 将系数按照小数点拆分
-    //如果是小数
+  var ret;
+  var zero = '0';
+  var parts = strNum.toLowerCase().split('e');
+  var e = parts.pop(); // 存储指数
+  // @ts-ignore
 
-    if (sign === -1) {
-      //拼接字符串，如果是小数，拼接0和小数点
-      num = zero + '.' + new Array(l).join(zero) + coeff_array.join('');
-    } else {
-      var dec = coeff_array[1]; //如果是整数，将整数除第一位之外的非零数字计入位数，相应的减少0的个数
+  var l = Math.abs(e); // 取绝对值，l-1就是0的个数
+  // @ts-ignore
+
+  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.3",
+  "version": "4.12.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",
@@ -61,6 +62,7 @@
     "@babel/preset-env": "^7.9.0",
     "@commitlint/cli": "^11.0.0",
     "@commitlint/config-conventional": "^11.0.0",
+    "@rollup/plugin-babel": "^5.3.1",
     "@rollup/plugin-commonjs": "^19.0.0",
     "@rollup/plugin-node-resolve": "^13.0.0",
     "@types/jest": "^26.0.23",

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/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

@@ -1,3 +1,10 @@
+/**
+ * 值是否为有效的数值
+ *
+ * @param {*} value 待检测的值
+ * @returns {boolean} 是否为有效的数值
+ */
+export function isEffectiveNumeric(value: any): boolean;
 /**
  * 是否为科学计数法数字
  *
@@ -51,6 +58,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,