util-helpers 4.16.1 → 4.17.0

package/lib/utils/math.util.js

@@ -1,204 +1,114 @@
-"use strict";
+'use strict';
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.checkBoundary = checkBoundary;
-exports.digitLength = digitLength;
-exports.float2Fixed = float2Fixed;
-exports.isScientificNumber = isScientificNumber;
-exports.scientificToNumber = scientificToNumber;
-exports.strip = strip;
-exports.transformEffectiveNumber = transformEffectiveNumber;
-exports.trimLeftZero = trimLeftZero;
-var _constants = require("./constants");
-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
- *
- * 解决浮动运算问题，避免小数点后产生多位数和计算精度损失。
- * 问题示例：2.3 + 2.4 = 4.699999999999999，1.0 - 0.9 = 0.09999999999999998
- */
+var constants = require('./constants.js');
+var devWarn = require('./devWarn.js');
+var isNumber = require('./type/isNumber.js');
+var isString = require('./type/isString.js');
+var isSymbol = require('./type/isSymbol.js');
 
-/**
- * 将值转换为有效数值
- * 
- * @param {*} value 要转换的值
- * @returns {number|string} 有效数值
- */
 function transformEffectiveNumber(value) {
-  /** @type {string|number|undefined} */
-  var ret;
-  if ((0, _type.isString)(value)) {
-    ret = value.trim(); // ' 15'  ' 15  ' 兼容 Number(string) 处理
-
-    if (ret === '') {
-      ret = Number(ret);
-    } else if (Number.isNaN(Number(ret))) {
-      // string如果可以转换为number，默认不转换为number类型
-      ret = Number.NaN;
+    var ret;
+    if (isString(value)) {
+        ret = value.trim();
+        if (ret === '') {
+            ret = Number(ret);
+        }
+        else if (Number.isNaN(Number(ret))) {
+            ret = Number.NaN;
+        }
     }
-  } else if ((0, _type.isSymbol)(value)) {
-    // 例如 Symbol 包装器对象将会报错
-    // symObj = Object(Symbol());
-    // Number(symObj); // TypeError: Cannot convert a Symbol value to a number
-    ret = Number.NaN;
-  } else if (!(0, _type.isNumber)(value)) {
-    // 其余非数字类型通过 Number 转换
-    ret = Number(value);
-  } else {
-    ret = value;
-  }
-  if (Number.isNaN(ret)) {
-    return Number.NaN;
-  }
-
-  // @ts-ignore
-  return ret;
+    else if (isSymbol(value)) {
+        ret = Number.NaN;
+    }
+    else if (!isNumber(value)) {
+        ret = Number(value);
+    }
+    else {
+        ret = value;
+    }
+    if (Number.isNaN(ret)) {
+        return Number.NaN;
+    }
+    return ret;
 }
-
-/**
- * 是否为科学计数法数字
- *
- * @param {string} num 检查值
- * @returns {boolean}
- */
 function isScientificNumber(num) {
-  return /\d+\.?\d*e[\+\-]*\d+/i.test(num);
+    return /\d+\.?\d*e[+-]*\d+/i.test(num);
 }
-
-/**
- * 把错误的数据转正
- *
- * @param {number} num 输入数
- * @param {number} [precision=12] 小数点的精度
- * @returns {number}
- * @example
- *
- *  strip(0.09999999999999998)=0.1
- */
-function strip(num) {
-  var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 12;
-  return +parseFloat(num.toPrecision(precision));
+function strip(num, precision) {
+    if (precision === void 0) { precision = 12; }
+    return +parseFloat(num.toPrecision(precision));
 }
-
-/**
- * 计算数字的小数点长度，支持科学记数法
- *
- * @param {number|string} num 输入数
- * @returns {number} 小数点长度
- */
 function digitLength(num) {
-  // Get digit length of e
-  var eSplit = num.toString().split(/e/i);
-  var len = (eSplit[0].split('.')[1] || '').length - +(eSplit[1] || 0);
-  return len > 0 ? len : 0;
+    var eSplit = num.toString().split(/e/i);
+    var len = (eSplit[0].split('.')[1] || '').length - +(eSplit[1] || 0);
+    return len > 0 ? len : 0;
 }
-
-/**
- * 把小数转成整数，支持科学计数法。如果是小数则放大成整数
- *
- * @param {number|string} num 输入数
- * @returns {number}
- */
 function float2Fixed(num) {
-  var strNum = String(num);
-  if (!isScientificNumber(strNum)) {
-    return Number(strNum.replace('.', ''));
-  }
-  var dLen = digitLength(num);
-  return dLen > 0 ? strip(+num * Math.pow(10, dLen)) : +num;
+    var strNum = String(num);
+    if (!isScientificNumber(strNum)) {
+        return Number(strNum.replace('.', ''));
+    }
+    var dLen = digitLength(num);
+    return dLen > 0 ? strip(+num * Math.pow(10, dLen)) : +num;
 }
-
-/**
- * 检测数字是否越界，如果越界给出提示
- * @param {number} num 输入数
- * @returns
- */
 function checkBoundary(num) {
-  if (+num > _constants.MAX_SAFE_INTEGER || +num < _constants.MIN_SAFE_INTEGER) {
-    (0, _devWarn["default"])("".concat(num, " is beyond boundary when transfer to integer, the results may not be accurate"));
-  }
+    if (+num > constants.MAX_SAFE_INTEGER || +num < constants.MIN_SAFE_INTEGER) {
+        devWarn("".concat(num, " is beyond boundary when transfer to integer, the results may not be accurate"));
+    }
 }
-
-/**
- * 去掉左边数字0
- *
- * @param {string} num 数字字符串
- * @returns {string}
- */
 function trimLeftZero(num) {
-  var reg = /^([+-])?(0+)([0-9\.]+)$/;
-  var result = reg.exec(num);
-  var sign;
-  if (result) {
-    sign = result[1] || '';
-    return sign + (result[3][0] === '.' ? '0' + result[3] : result[3]);
-  }
-  return num;
+    var reg = /^([+-])?(0+)([0-9.]+)$/;
+    var result = reg.exec(num);
+    var sign;
+    if (result) {
+        sign = result[1] || '';
+        return sign + (result[3][0] === '.' ? '0' + result[3] : result[3]);
+    }
+    return num;
 }
-
-/**
- * 科学计数法转换成普通数字
- *
- * JavaScript在以下情景会自动将数值转换为科学计数法：
- *  1.小数点前的数字个数大于等于22位
- *  2.小数点前边是0，小数点后十分位（包含十分位）之后连续零的个数大于等于6个
- *
- * @param {string | number} num 科学计数法数字
- * @returns {string | number} 转换后的数字字符串
- */
 function scientificToNumber(num) {
-  var strNum = String(num);
-  if (!isScientificNumber(strNum)) {
-    return num;
-  }
-
-  /** @type string */
-  var ret;
-  var zero = '0';
-  var parts = strNum.toLowerCase().split('e');
-  var e = parts.pop(); // 存储指数
-  // @ts-ignore
-  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 (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('');
+    var strNum = String(num);
+    if (!isScientificNumber(strNum)) {
+        return num;
     }
-  } else {
-    // 小数部分
-    var _dec = coeff_array[1] || '';
-
-    // 如果是整数，将整数除第一位之外的非零数字计入位数，相应的减少0的个数
-    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);
+    var ret;
+    var zero = '0';
+    var parts = strNum.toLowerCase().split('e');
+    var e = parts.pop();
+    var l = Math.abs(e);
+    var sign = e / l;
+    var coeff_array = parts[0].split('.');
+    if (sign === -1) {
+        var intVal = trimLeftZero(coeff_array[0]);
+        if (intVal.length > l) {
+            var thanLen = intVal.length - l;
+            var dec = coeff_array[1] || '';
+            ret = intVal.slice(0, thanLen);
+            if (intVal.slice(thanLen) !== '0' || dec) {
+                ret += '.' + intVal.slice(thanLen) + dec;
+            }
+        }
+        else {
+            ret = zero + '.' + new Array(l - intVal.length + 1).join(zero) + coeff_array.join('');
+        }
+    }
+    else {
+        var dec = coeff_array[1] || '';
+        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);
-}
+    return trimLeftZero(ret);
+}
+
+exports.checkBoundary = checkBoundary;
+exports.digitLength = digitLength;
+exports.float2Fixed = float2Fixed;
+exports.isScientificNumber = isScientificNumber;
+exports.scientificToNumber = scientificToNumber;
+exports.strip = strip;
+exports.transformEffectiveNumber = transformEffectiveNumber;
+exports.trimLeftZero = trimLeftZero;

package/lib/utils/type/isBlob.js

@@ -1,34 +1,9 @@
-"use strict";
+'use strict';
+
+var isType = require('./isType.js');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _isType = _interopRequireDefault(require("./isType"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-/**
- * 检查值是否为Blob对象<br/><br/>
- * 
- * <em style="font-weight: bold;">注意：该方法仅适用于浏览器端。</em>
- *
- * @static
- * @alias module:Type.isBlob
- * @since 4.16.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为Blob对象
- * @example
- *
- * isBlob(new Blob(['a']))
- * // => true
- *
- * isBlob({})
- * // => false
- *
- * isBlob('2012')
- * // => false
- */
 function isBlob(value) {
-  return (0, _isType["default"])(value, 'Blob');
+    return isType(value, 'Blob');
 }
-var _default = isBlob;
-exports["default"] = _default;
+
+module.exports = isBlob;

package/lib/utils/type/isNaN.js

@@ -1,29 +1,9 @@
-"use strict";
+'use strict';
+
+var isType = require('./isType.js');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _isType = _interopRequireDefault(require("./isType"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-/**
- * 检查值是否为NaN
- *
- * @static
- * @alias module:Type.isNaN
- * @since 1.1.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为NaN
- * @example
- *
- * isNaN(NaN)
- * // => true
- *
- * isNaN(1)
- * // => false
- */
 function _isNaN(value) {
-  return (0, _isType["default"])(value, 'Number') && isNaN(value);
+    return isType(value, 'Number') && isNaN(value);
 }
-var _default = _isNaN;
-exports["default"] = _default;
+
+module.exports = _isNaN;

package/lib/utils/type/isNil.js

@@ -1,23 +1,10 @@
-"use strict";
+'use strict';
+
+var isUndefined = require('./isUndefined.js');
+var isNull = require('./isNull.js');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _isUndefined = _interopRequireDefault(require("./isUndefined"));
-var _isNull = _interopRequireDefault(require("./isNull"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-/**
- * 检查值是否为 undefined 或 null
- *
- * @static
- * @alias module:Type.isNaN
- * @since 4.3.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为 undefined 或 null
- */
 function isNil(value) {
-  return (0, _isUndefined["default"])(value) || (0, _isNull["default"])(value);
+    return isUndefined(value) || isNull(value);
 }
-var _default = isNil;
-exports["default"] = _default;
+
+module.exports = isNil;

package/lib/utils/type/isNull.js

@@ -1,27 +1,7 @@
-"use strict";
+'use strict';
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = 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;
+    return value === null;
 }
-var _default = isNull;
-exports["default"] = _default;
+
+module.exports = isNull;

package/lib/utils/type/isNumber.js

@@ -1,38 +1,9 @@
-"use strict";
+'use strict';
+
+var isType = require('./isType.js');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _isType = _interopRequireDefault(require("./isType"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-/**
- * 检查值是否为Number
- *
- * @static
- * @alias module:Type.isNumber
- * @since 1.1.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为Number
- * @example
- *
- * isNumber(1)
- * // => true
- *
- * isNumber(Number.MIN_VALUE)
- * // => true
- *
- * isNumber(Infinity)
- * // => true
- *
- * isNumber(NaN)
- * // => true
- *
- * isNumber('1')
- * // => false
- */
 function isNumber(value) {
-  return (0, _isType["default"])(value, 'Number');
+    return isType(value, 'Number');
 }
-var _default = isNumber;
-exports["default"] = _default;
+
+module.exports = isNumber;

package/lib/utils/type/isObject.js

@@ -1,32 +1,8 @@
-"use strict";
+'use strict';
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
-/**
- * 检查值是否为Object
- *
- * @static
- * @alias module:Type.isObject
- * @since 1.1.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为Object
- * @example
- *
- * isObject({})
- * // => true
- *
- * isObject([1,2,3])
- * // => true
- *
- * isObject(null)
- * // => false
- */
 function isObject(value) {
-  var type = _typeof(value);
-  return value != null && (type === 'object' || type === 'function');
+    var type = typeof value;
+    return value != null && (type === 'object' || type === 'function');
 }
-var _default = isObject;
-exports["default"] = _default;
+
+module.exports = isObject;

package/lib/utils/type/isString.js

@@ -1,29 +1,9 @@
-"use strict";
+'use strict';
+
+var isType = require('./isType.js');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _isType = _interopRequireDefault(require("./isType"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-/**
- * 检查值是否为String
- *
- * @static
- * @alias module:Type.isString
- * @since 1.1.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为String
- * @example
- *
- * isString('abc')
- * // => true
- *
- * isString(1)
- * // => false
- */
 function isString(value) {
-  return (0, _isType["default"])(value, 'String');
+    return isType(value, 'String');
 }
-var _default = isString;
-exports["default"] = _default;
+
+module.exports = isString;

package/lib/utils/type/isSymbol.js

@@ -1,29 +1,9 @@
-"use strict";
+'use strict';
+
+var isType = require('./isType.js');
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-var _isType = _interopRequireDefault(require("./isType"));
-function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
-/**
- * 检查值是否为Symbol
- *
- * @static
- * @alias module:Type.isSymbol
- * @since 1.1.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为Symbol
- * @example
- *
- * isSymbol(Symbol.iterator)
- * // => true
- *
- * isSymbol("abc")
- * // => false
- */
 function isSymbol(value) {
-  return (0, _isType["default"])(value, 'Symbol');
+    return isType(value, 'Symbol');
 }
-var _default = isSymbol;
-exports["default"] = _default;
+
+module.exports = isSymbol;

package/lib/utils/type/isType.js

@@ -1,22 +1,8 @@
-"use strict";
+'use strict';
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
 var toString = Object.prototype.toString;
-
-/**
- * 检测值的 `toString` 类型
- *
- * @private
- * @since 1.1.0
- * @param {*} value 检查值
- * @param {string} typename 类型名称
- * @returns {boolean} 返回值的 `toString` 类型是否匹配
- */
 function isType(value, typename) {
-  return toString.call(value) === "[object ".concat(typename, "]");
+    return toString.call(value) === "[object ".concat(typename, "]");
 }
-var _default = isType;
-exports["default"] = _default;
+
+module.exports = isType;

package/lib/utils/type/isUndefined.js

@@ -1,30 +1,7 @@
-"use strict";
+'use strict';
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports["default"] = void 0;
-/**
- * 检查值是否为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;
+    return value === void 0;
 }
-var _default = isUndefined;
-exports["default"] = _default;
+
+module.exports = isUndefined;