util-helpers 4.16.2 → 4.17.1

package/esm/utils/math.util.js

@@ -1,191 +1,105 @@
-/**
- * 参考: https://github.com/nefe/number-precision/blob/master/src/index.ts
- *
- * 解决浮动运算问题，避免小数点后产生多位数和计算精度损失。
- * 问题示例：2.3 + 2.4 = 4.699999999999999，1.0 - 0.9 = 0.09999999999999998
- */
-
-import { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from './constants';
-import devWarn from './devWarn';
-import { isNumber, isString, isSymbol } from './type';
-
-/**
- * 将值转换为有效数值
- * 
- * @param {*} value 要转换的值
- * @returns {number|string} 有效数值
- */
-export function transformEffectiveNumber(value) {
-  /** @type {string|number|undefined} */
-  var ret;
-  if (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;
+import { MAX_SAFE_INTEGER, MIN_SAFE_INTEGER } from './constants.js';
+import devWarn from './devWarn.js';
+import isNumber from './type/isNumber.js';
+import isString from './type/isString.js';
+import isSymbol from './type/isSymbol.js';
+
+function transformEffectiveNumber(value) {
+    var ret;
+    if (isString(value)) {
+        ret = value.trim();
+        if (ret === '') {
+            ret = Number(ret);
+        }
+        else if (Number.isNaN(Number(ret))) {
+            ret = Number.NaN;
+        }
     }
-  } else if (isSymbol(value)) {
-    // 例如 Symbol 包装器对象将会报错
-    // symObj = Object(Symbol());
-    // Number(symObj); // TypeError: Cannot convert a Symbol value to a number
-    ret = Number.NaN;
-  } else if (!isNumber(value)) {
-    // 其余非数字类型通过 Number 转换
-    ret = Number(value);
-  } else {
-    ret = value;
-  }
-  if (Number.isNaN(ret)) {
-    return Number.NaN;
-  }
-
-  // @ts-ignore
-  return ret;
-}
-
-/**
- * 是否为科学计数法数字
- *
- * @param {string} num 检查值
- * @returns {boolean}
- */
-export function isScientificNumber(num) {
-  return /\d+\.?\d*e[\+\-]*\d+/i.test(num);
+    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 {number} num 输入数
- * @param {number} [precision=12] 小数点的精度
- * @returns {number}
- * @example
- *
- *  strip(0.09999999999999998)=0.1
- */
-export function strip(num) {
-  var precision = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 12;
-  return +parseFloat(num.toPrecision(precision));
+function isScientificNumber(num) {
+    return /\d+\.?\d*e[+-]*\d+/i.test(num);
 }
-
-/**
- * 计算数字的小数点长度，支持科学记数法
- *
- * @param {number|string} num 输入数
- * @returns {number} 小数点长度
- */
-export 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;
+function strip(num, precision) {
+    if (precision === void 0) { precision = 12; }
+    return +parseFloat(num.toPrecision(precision));
 }
-
-/**
- * 把小数转成整数，支持科学计数法。如果是小数则放大成整数
- *
- * @param {number|string} num 输入数
- * @returns {number}
- */
-export 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;
+function digitLength(num) {
+    var eSplit = num.toString().split(/e/i);
+    var len = (eSplit[0].split('.')[1] || '').length - +(eSplit[1] || 0);
+    return len > 0 ? len : 0;
 }
-
-/**
- * 检测数字是否越界，如果越界给出提示
- * @param {number} num 输入数
- * @returns
- */
-export function checkBoundary(num) {
-  if (+num > MAX_SAFE_INTEGER || +num < MIN_SAFE_INTEGER) {
-    devWarn("".concat(num, " is beyond boundary when transfer to integer, the results may not be accurate"));
-  }
+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;
 }
-
-/**
- * 去掉左边数字0
- *
- * @param {string} num 数字字符串
- * @returns {string}
- */
-export 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;
+function checkBoundary(num) {
+    if (+num > MAX_SAFE_INTEGER || +num < MIN_SAFE_INTEGER) {
+        devWarn("".concat(num, " is beyond boundary when transfer to integer, the results may not be accurate"));
+    }
 }
-
-/**
- * 科学计数法转换成普通数字
- *
- * JavaScript在以下情景会自动将数值转换为科学计数法：
- *  1.小数点前的数字个数大于等于22位
- *  2.小数点前边是0，小数点后十分位（包含十分位）之后连续零的个数大于等于6个
- *
- * @param {string | number} num 科学计数法数字
- * @returns {string | number} 转换后的数字字符串
- */
-export function scientificToNumber(num) {
-  var strNum = String(num);
-  if (!isScientificNumber(strNum)) {
+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;
-  }
-
-  /** @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('');
+}
+function scientificToNumber(num) {
+    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('');
+        }
     }
-  }
-  return trimLeftZero(ret);
-}
+    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);
+}
+
+export { checkBoundary, digitLength, float2Fixed, isScientificNumber, scientificToNumber, strip, transformEffectiveNumber, trimLeftZero };

package/esm/utils/type/isBlob.js

@@ -1,27 +1,7 @@
-import isType from './isType';
+import isType from './isType.js';
 
-/**
- * 检查值是否为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 isType(value, 'Blob');
+    return isType(value, 'Blob');
 }
-export default isBlob;
+
+export { isBlob as default };

package/esm/utils/type/isNaN.js

@@ -1,22 +1,7 @@
-import isType from './isType';
+import isType from './isType.js';
 
-/**
- * 检查值是否为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 isType(value, 'Number') && isNaN(value);
+    return isType(value, 'Number') && isNaN(value);
 }
-export default _isNaN;
+
+export { _isNaN as default };

package/esm/utils/type/isNil.js

@@ -1,16 +1,8 @@
-import isUndefined from './isUndefined';
-import isNull from './isNull';
+import isUndefined from './isUndefined.js';
+import isNull from './isNull.js';
 
-/**
- * 检查值是否为 undefined 或 null
- *
- * @static
- * @alias module:Type.isNaN
- * @since 4.3.0
- * @param {*} value 检查值
- * @returns {boolean} 是否为 undefined 或 null
- */
 function isNil(value) {
-  return isUndefined(value) || isNull(value);
+    return isUndefined(value) || isNull(value);
 }
-export default isNil;
+
+export { isNil as default };

package/esm/utils/type/isNull.js

@@ -1,20 +1,5 @@
-/**
- * 检查值是否为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;
 }
-export default isNull;
+
+export { isNull as default };

package/esm/utils/type/isNumber.js

@@ -1,31 +1,7 @@
-import isType from './isType';
+import isType from './isType.js';
 
-/**
- * 检查值是否为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 isType(value, 'Number');
+    return isType(value, 'Number');
 }
-export default isNumber;
+
+export { isNumber as default };

package/esm/utils/type/isObject.js

@@ -1,25 +1,6 @@
-import _typeof from "@babel/runtime/helpers/typeof";
-/**
- * 检查值是否为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');
 }
-export default isObject;
+
+export { isObject as default };

package/esm/utils/type/isString.js

@@ -1,22 +1,7 @@
-import isType from './isType';
+import isType from './isType.js';
 
-/**
- * 检查值是否为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 isType(value, 'String');
+    return isType(value, 'String');
 }
-export default isString;
+
+export { isString as default };

package/esm/utils/type/isSymbol.js

@@ -1,22 +1,7 @@
-import isType from './isType';
+import isType from './isType.js';
 
-/**
- * 检查值是否为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 isType(value, 'Symbol');
+    return isType(value, 'Symbol');
 }
-export default isSymbol;
+
+export { isSymbol as default };

package/esm/utils/type/isType.js

@@ -1,15 +1,6 @@
 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, "]");
 }
-export default isType;
+
+export { isType as default };

package/esm/utils/type/isUndefined.js

@@ -1,23 +1,5 @@
-/**
- * 检查值是否为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;
 }
-export default isUndefined;
+
+export { isUndefined as default };