@ivujs/i-utils 2.1.0 → 2.1.2

package/dist/es/math/index.mjs

@@ -35,7 +35,7 @@ function add(arg1, arg2) {
  * @returns {number} 返回计算后的数字
  */
 function subtract(arg1, arg2) {
-    let r1, r2, m, n;
+    let r1, r2;
     try {
         r1 = arg1.toString().split(".")[1].length;
     }
@@ -48,15 +48,15 @@ function subtract(arg1, arg2) {
     catch (e) {
         r2 = 0;
     }
-    m = Math.pow(10, Math.max(r1, r2));
-    n = r1 >= r2 ? r1 : r2;
-    return ((Number(arg1) * m - Number(arg2) * m) / m).toFixed(n);
+    const m = Math.pow(10, Math.max(r1, r2));
+    const n = r1 >= r2 ? r1 : r2;
+    return Number(((Number(arg1) * m - Number(arg2) * m) / m).toFixed(n));
 }
 /**
  * 两个数字相乘
  * @param {string|number} arg1 第一个数字
  * @param {string|number} arg2 第二个数字
- * @returns 返回计算后的数字
+ * @returns {number} 返回计算后的数字
  */
 function multiply(arg1, arg2) {
     let m = 0;
@@ -158,9 +158,12 @@ function toFixed(num, decimals = 2, mode = MATH.ROUND) {
         return _toFixedRound(num, decimals);
     }
     // 向下舍出
-    if (mode === MATH.ROUND_FLOOR) {
+    else if (mode === MATH.ROUND_FLOOR) {
         return _toFixedFloor(num, decimals);
     }
+    else {
+        throw new Error("toFixed is error");
+    }
 }
 /**
  * 尽可能保留小数位数
@@ -172,11 +175,15 @@ function toFixed(num, decimals = 2, mode = MATH.ROUND) {
 function toDecimal(num, decimals = 2, mode = MATH.ROUND) {
     // 四舍五入
     if (mode === MATH.ROUND) {
-        return _toDecimalRound(num, decimals);
+        return Number(_toDecimalRound(num, decimals));
     }
     // 向下舍出
-    if (mode === MATH.ROUND_FLOOR) {
-        return _toDecimalFloor(num, decimals);
+    else if (mode === MATH.ROUND_FLOOR) {
+        return Number(_toDecimalFloor(num, decimals));
+    }
+    // 错误保留格式
+    else {
+        throw new Error("toDecimal is error");
     }
 }
 /* 内部函数 */
@@ -233,13 +240,17 @@ function _toFixedRound(num, decimals = 2) {
  * @description 默认保留两位小数，此方法相当于强制截取小数位数
  * @param {string|number} num 数字
  * @param {number} decimals 保留小数的位数，默认2位
- * @returns {number} 返回字符串的数字
+ * @returns {string} 返回字符串的数字
  */
 function _toFixedFloor(num, decimals = 2) {
-    // 修复1：num可能是字符串，先转数字再判断NaN
+    // num可能是字符串，先转数字再判断NaN
     const numVal = Number(num);
     if (isNaN(numVal)) {
-        return "--";
+        throw new Error(`${num} is NaN`);
+    }
+    // 校验小数位数范围
+    if (decimals < 0 || decimals > 20) {
+        throw new Error("Decimal places must be between 0 and 20");
     }
     // 默认为保留的小数点后两位
     const dec = Math.max(0, Math.floor(decimals)); // 确保小数位数为非负整数
@@ -274,11 +285,11 @@ function _toFixedFloor(num, decimals = 2) {
  * 四舍五入，尽可能保留小数
  * @param {string|number} num 数字
  * @param {number} decimals 保留小数的位数，默认2位
- * @returns {number} 返回保留后的数字
+ * @returns {string} 返回保留后的数字
  */
 function _toDecimalRound(num, decimals = 2) {
     if (isNaN(Number(num))) {
-        return "--";
+        throw new Error(`${num} is not a number`);
     }
     const n = Math.pow(10, decimals);
     return Math.round(Number(num) * n) / n;
@@ -291,7 +302,7 @@ function _toDecimalRound(num, decimals = 2) {
  */
 function _toDecimalFloor(num, decimals = 2) {
     if (isNaN(Number(num))) {
-        return "--";
+        throw new Error(`${num} is not a number`);
     }
     const n = Math.pow(10, decimals);
     return Math.floor(Number(num) * n) / n;

package/dist/es/object/index.d.ts

@@ -69,7 +69,7 @@ export declare function merge(target: Record<any, any>, ...source: Record<any, a
  * this._getValueByPath(res, 'data.pages.pageSize'); // 这里会输出20
  * @param {Object} target 目标对象
  * @param {string} path 字符串属性路径
- * @returns {Object} 返回目标对象
+ * @returns {*} 返回目标对象的值
  */
 export declare function getValueByPath(target: Record<any, any>, path?: string): any;
 /**
@@ -80,5 +80,6 @@ export declare function getValueByPath(target: Record<any, any>, path?: string):
  * @param {Object} target 目标对象
  * @param {string} path 字符串属性路径
  * @param {*} value 值
+ * @returns {*} 返回修改过后的目标对象
  */
 export declare function setValueByPath(target: Record<any, any>, path: string | undefined, value: any): Record<any, any>;

package/dist/es/object/index.mjs

@@ -199,7 +199,7 @@ function merge(target, ...source) {
  * this._getValueByPath(res, 'data.pages.pageSize'); // 这里会输出20
  * @param {Object} target 目标对象
  * @param {string} path 字符串属性路径
- * @returns {Object} 返回目标对象
+ * @returns {*} 返回目标对象的值
  */
 function getValueByPath(target, path = "data") {
     const paths = (path || "data").split(".");
@@ -211,7 +211,7 @@ function getValueByPath(target, path = "data") {
         if (isArray) {
             // 获取的数组下标超出实际的长度
             if (propIndex < 0 || propIndex >= current[propName].length) {
-                return undefined;
+                return;
             }
             // 逐层向下找到对应属性的值
             current = current[propName][propIndex];
@@ -220,7 +220,7 @@ function getValueByPath(target, path = "data") {
         else {
             // 如果属性不存在，则返回空的
             if (!current || !current.hasOwnProperty(part) || typeof current !== "object") {
-                return undefined;
+                return;
             }
             // 逐层向下找到对应属性的值
             current = current[part];
@@ -236,6 +236,7 @@ function getValueByPath(target, path = "data") {
  * @param {Object} target 目标对象
  * @param {string} path 字符串属性路径
  * @param {*} value 值
+ * @returns {*} 返回修改过后的目标对象
  */
 function setValueByPath(target, path = "data", value) {
     const paths = (path || "data").split(".");
@@ -292,7 +293,7 @@ function setValueByPath(target, path = "data", value) {
 /**
  * 获得目标路径的片段
  * @param {string} path
- * @returns {{propName: (*|undefined), propIndex: (*|number|undefined), isArray: boolean}}
+ * @returns {*} 返回获得到的值
  */
 function _getTargetPathPart(path) {
     const pathArrayMatch = path.match(/^(\w+)\[(\d+)]$/);

package/dist/es/string/index.d.ts

@@ -1,6 +1,3 @@
-/**
- * @module 字符串
- */
 /**
  * 字符串中是否包含指定的元素
  * @param {string} value 包含的元素
@@ -58,14 +55,14 @@ export declare function toLowerCase(value: string): string;
  * @param {string} value 参数
  * @returns {string} 返回处理后的字符串
  */
-export declare function toSnakeCase(value: string): string | undefined;
+export declare function toSnakeCase(value: string): string;
 /**
  * 转为 kebab-case 短横命名
  * @description 支持 下划线，驼峰命名，帕斯卡命名
  * @param {string} value 参数
  * @returns {string} 返回处理后的字符串
  */
-export declare function toKebabCase(value: string): string | undefined;
+export declare function toKebabCase(value: string): string;
 /**
  * 转为 camelCase 驼峰命名
  * @description 支持 下划线命名，短横命名，帕斯卡命名
@@ -87,7 +84,7 @@ export declare function toPascalCase(value: string): string;
  * @param {number} maxLength 补齐0后的最大长度，默认2位
  * @returns {string} 返回补0后指定位数的字符串
  */
-export declare function zeroStart(value: string, maxLength?: number): string;
+export declare function padZeroStart(value: string | number, maxLength?: number): string;
 /**
  * 数字后补齐0达到指定位数
  * @description 相当于原生的 padEnd(2,'0')
@@ -95,7 +92,7 @@ export declare function zeroStart(value: string, maxLength?: number): string;
  * @param {number} maxLength 补齐0后的最大长度，默认2位
  * @returns {string} 返回补0后指定位数的字符串
  */
-export declare function zeroEnd(value: string, maxLength?: number): string;
+export declare function padZeroEnd(value: string | number, maxLength?: number): string;
 /**
  * 格式化为标题样式
  * @param {string} value 字符串值

package/dist/es/string/index.mjs

@@ -1,3 +1,5 @@
+import { isNull, isNaN } from '../validate/index.mjs';
+
 /**
  * @module 字符串
  */
@@ -82,14 +84,18 @@ function toSnakeCase(value) {
         return value.replace(/([A-Z])/g, "_$1").toLowerCase();
     }
     // 短横
-    if (value.indexOf("-") > 0) {
+    else if (value.indexOf("-") > 0) {
         return value.replace(/-/g, "_").toLowerCase();
     }
     // 帕斯卡
-    if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+    else if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
         value = value.charAt(0).toLowerCase() + value.slice(1);
         return value.replace(/([A-Z])/g, "_$1").toLowerCase();
     }
+    // 不符合格式
+    else {
+        throw new TypeError("value should be a string");
+    }
 }
 /**
  * 转为 kebab-case 短横命名
@@ -103,14 +109,18 @@ function toKebabCase(value) {
         return value.replace(/_/g, "-").toLowerCase();
     }
     // 驼峰
-    if (/^[a-z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+    else if (/^[a-z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
         return value.replace(/([A-Z])/g, "-$1").toLowerCase();
     }
     // 帕斯卡
-    if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
+    else if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
         const newStr = value.charAt(0).toLowerCase() + value.slice(1);
         return newStr.replace(/([A-Z])/g, "-$1").toLowerCase();
     }
+    // 不符合格式
+    else {
+        throw new TypeError("value should be a string");
+    }
 }
 /**
  * 转为 camelCase 驼峰命名
@@ -135,9 +145,9 @@ function toCamelCase(value) {
     else if (/^[A-Z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
         return value.charAt(0).toLowerCase() + value.slice(1);
     }
-    // 返回自身
+    // 不符合格式
     else {
-        return value;
+        throw new TypeError("value should be a string");
     }
 }
 /**
@@ -165,9 +175,9 @@ function toPascalCase(value) {
     else if (/^[a-z]$/.test(value.charAt(0)) && !(value.indexOf("-") > 0 || value.indexOf("_") > 0)) {
         return value.charAt(0).toUpperCase() + value.slice(1);
     }
-    // 返回自身
+    // 不符合格式
     else {
-        return value;
+        throw new TypeError("value should be a string");
     }
 }
 /* 字符串格式化 */
@@ -178,7 +188,15 @@ function toPascalCase(value) {
  * @param {number} maxLength 补齐0后的最大长度，默认2位
  * @returns {string} 返回补0后指定位数的字符串
  */
-function zeroStart(value, maxLength = 2) {
+function padZeroStart(value, maxLength = 2) {
+    value = String(value).trim();
+    if (maxLength < 0) {
+        throw new TypeError("maxLength should be greater than 0");
+    }
+    if (isNull(value) || isNaN(value)) {
+        throw new Error("value must be a valid number or numeric string");
+    }
+    // 前面补0
     let len = value.toString().length;
     while (len < maxLength) {
         value = "0" + value;
@@ -193,7 +211,15 @@ function zeroStart(value, maxLength = 2) {
  * @param {number} maxLength 补齐0后的最大长度，默认2位
  * @returns {string} 返回补0后指定位数的字符串
  */
-function zeroEnd(value, maxLength = 2) {
+function padZeroEnd(value, maxLength = 2) {
+    value = String(value).trim();
+    if (maxLength < 0) {
+        throw new TypeError("maxLength should be greater than 0");
+    }
+    if (isNull(value) || isNaN(value)) {
+        throw new Error("value must be a valid number or numeric string");
+    }
+    // 后面补0
     let len = value.toString().length;
     while (len < maxLength) {
         value = value + "0";
@@ -339,4 +365,4 @@ function formatRmbChinese(money) {
     return chineseStr;
 }
 
-export { formatRmbChinese, formatTemplate, formatThousand, formatTitle, inString, replaceAll, toCamelCase, toKebabCase, toLowerCase, toPascalCase, toSnakeCase, toUpperCase, trim, trimAll, trimEnd, trimStart, zeroEnd, zeroStart };
+export { formatRmbChinese, formatTemplate, formatThousand, formatTitle, inString, padZeroEnd, padZeroStart, replaceAll, toCamelCase, toKebabCase, toLowerCase, toPascalCase, toSnakeCase, toUpperCase, trim, trimAll, trimEnd, trimStart };

package/dist/es/url/index.mjs

@@ -13,7 +13,7 @@ import { arrayInsertBefore, arrayInsertAfter } from '../array/index.mjs';
 function getProtocol(url = window.location.href) {
     const match = url.match(REGEXP.URL);
     if (match) {
-        return match[1] || "";
+        return match[1];
     }
 }
 /**
@@ -35,7 +35,7 @@ function getHost(url = window.location.href) {
 function getHostName(url = window.location.href) {
     const match = url.match(REGEXP.URL);
     if (match) {
-        return match[2] || "";
+        return match[2];
     }
 }
 /**
@@ -46,7 +46,7 @@ function getHostName(url = window.location.href) {
 function getPort(url = window.location.href) {
     const match = url.match(REGEXP.URL);
     if (match) {
-        return match[3] || "";
+        return match[3];
     }
 }
 /**
@@ -57,7 +57,7 @@ function getPort(url = window.location.href) {
 function getUrlPath(url = window.location.href) {
     const match = url.match(REGEXP.URL);
     if (match) {
-        return match[4] || "";
+        return match[4];
     }
 }
 /**
@@ -68,7 +68,7 @@ function getUrlPath(url = window.location.href) {
 function getUrlHash(url = window.location.href) {
     const match = url.match(REGEXP.URL);
     if (match) {
-        return match[6] || "";
+        return match[6];
     }
 }
 /**
@@ -79,7 +79,7 @@ function getUrlHash(url = window.location.href) {
 function getSearchString(url = window.location.href) {
     const match = url.match(REGEXP.URL);
     if (match) {
-        return match[5] || "";
+        return match[5];
     }
 }
 /**

package/dist/es/validate/index.mjs

@@ -217,8 +217,12 @@ function isFalse(value) {
  * @returns {boolean} 返回结果
  */
 function isNaN(value) {
-    // window的isNaN函数是有缺陷的，空数组/数组有一个元素，null，空字符串 都会被认为是数字
-    return window.isNaN(value) || isArray(value) || value == null || value === "";
+    return (value == null || // 匹配 null/undefined
+        typeof value === "boolean" || // 布尔值视为非数字
+        Array.isArray(value) || // 数组视为非数字
+        value === "" || // 空字符串视为非数字
+        window.isNaN(Number(value)) // 原生isNaN判断（转数字后是否为NaN）
+    );
 }
 /**
  * 判断是数字