@ivujs/i-utils 2.1.3 → 2.1.5

package/dist/lib/index.full.umd.js

@@ -1,5 +1,5 @@
 /*!
- * @ivujs/i-utils v2.1.3
+ * @ivujs/i-utils v2.1.5
  * Copyright 2021-2026, <gao911222@163.com>
  * Released under the MIT License.
  */
@@ -908,7 +908,7 @@
             typeof value === "boolean" || // 布尔值视为非数字
             Array.isArray(value) || // 数组视为非数字
             value === "" || // 空字符串视为非数字
-            window.isNaN(Number(value)) // 原生isNaN判断（转数字后是否为NaN）
+            (window && window.isNaN(Number(value))) // 原生isNaN判断（转数字后是否为NaN）
         );
     }
     /**
@@ -1229,7 +1229,7 @@
         }
         // 不符合格式
         else {
-            throw new TypeError("value should be a string");
+            throw new TypeError(`toSnakeCase: value should be a string`);
         }
     }
     /**
@@ -1254,7 +1254,7 @@
         }
         // 不符合格式
         else {
-            throw new TypeError("value should be a string");
+            throw new TypeError("toKebabCase: value should be a string");
         }
     }
     /**
@@ -1282,7 +1282,7 @@
         }
         // 不符合格式
         else {
-            throw new TypeError("value should be a string");
+            throw new TypeError("toCamelCase: value should be a string");
         }
     }
     /**
@@ -1312,7 +1312,7 @@
         }
         // 不符合格式
         else {
-            throw new TypeError("value should be a string");
+            throw new TypeError("toPascalCase: value should be a string");
         }
     }
     /* 字符串格式化 */
@@ -1326,10 +1326,10 @@
     function padZeroStart(value, maxLength = 2) {
         value = String(value).trim();
         if (maxLength < 0) {
-            throw new TypeError("maxLength should be greater than 0");
+            throw new TypeError("padZeroStart: maxLength should be greater than 0");
         }
         if (isNull(value) || isNaN(value)) {
-            throw new Error("value must be a valid number or numeric string");
+            throw new TypeError("padZeroStart: value must be a valid number or numeric string");
         }
         // 前面补0
         let len = value.toString().length;
@@ -1349,10 +1349,10 @@
     function padZeroEnd(value, maxLength = 2) {
         value = String(value).trim();
         if (maxLength < 0) {
-            throw new TypeError("maxLength should be greater than 0");
+            throw new TypeError("padZeroEnd: maxLength should be greater than 0");
         }
         if (isNull(value) || isNaN(value)) {
-            throw new Error("value must be a valid number or numeric string");
+            throw new TypeError("padZeroEnd: value must be a valid number or numeric string");
         }
         // 后面补0
         let len = value.toString().length;
@@ -1438,7 +1438,7 @@
         money = parseFloat(String(money));
         if (money >= maxNum) {
             // 超出最大处理数字，抛出异常
-            throw new Error("Calculated number overflow!");
+            throw new TypeError("formatRmbChinese: calculated number overflow");
         }
         if (money === 0) {
             chineseStr = cnNums[0] + cnIntLast + cnInteger;
@@ -3457,7 +3457,7 @@
     function toDate(value) {
         // 为空抛出异常
         if (isNull(value)) {
-            throw new TypeError("value cannot be null or undefined");
+            throw new TypeError("toDate: value cannot be null or undefined");
         }
         // 是日期字符串
         if (isString(value)) {
@@ -3473,7 +3473,7 @@
         }
         // 不支持的日期格式
         else {
-            throw new TypeError(`invalid input type: ${typeof value}, expected string or number`);
+            throw new TypeError(`toDate: invalid input type: ${typeof value}, expected string or number`);
         }
     }
     /**
@@ -3487,11 +3487,11 @@
         const { format = "yyyy-MM-dd", lang = "zh" } = options;
         // 为空抛出异常
         if (isNull(date)) {
-            throw new TypeError("date cannot be null or undefined");
+            throw new TypeError("toDateString: date cannot be null or undefined");
         }
         // 判断是否是日期对象
         if (!isDate(date)) {
-            throw new TypeError(`invalid input type: ${typeof date}, expected Date object`);
+            throw new TypeError(`toDateString: invalid input type: ${typeof date}, expected Date object`);
         }
         // 日期转化替换
         const replaceRules = {
@@ -3746,7 +3746,7 @@
             return _toFixedFloor(num, decimals);
         }
         else {
-            throw new Error("toFixed is error");
+            throw new TypeError("toFixed: mode is MATH.ROUND 0 or MATH.ROUND_FLOOR");
         }
     }
     /**
@@ -3767,7 +3767,7 @@
         }
         // 错误保留格式
         else {
-            throw new Error("toDecimal is error");
+            throw new TypeError("toDecimal: mode is MATH.ROUND 0 or MATH.ROUND_FLOOR");
         }
     }
     /* 内部函数 */
@@ -3830,11 +3830,11 @@
         // num可能是字符串，先转数字再判断NaN
         const numVal = Number(num);
         if (isNaN(numVal)) {
-            throw new Error(`${num} is NaN`);
+            throw new TypeError(`${num} is NaN`);
         }
         // 校验小数位数范围
         if (decimals < 0 || decimals > 20) {
-            throw new Error("Decimal places must be between 0 and 20");
+            throw new TypeError("_toFixedFloor: decimals places must be between 0 and 20");
         }
         // 默认为保留的小数点后两位
         const dec = Math.max(0, Math.floor(decimals)); // 确保小数位数为非负整数
@@ -3873,7 +3873,7 @@
      */
     function _toDecimalRound(num, decimals = 2) {
         if (isNaN(Number(num))) {
-            throw new Error(`${num} is not a number`);
+            throw new TypeError(`_toDecimalRound: ${num} is not a number`);
         }
         const n = Math.pow(10, decimals);
         return Math.round(Number(num) * n) / n;
@@ -3886,7 +3886,7 @@
      */
     function _toDecimalFloor(num, decimals = 2) {
         if (isNaN(Number(num))) {
-            throw new Error(`${num} is not a number`);
+            throw new TypeError(`_toDecimalFloor: ${num} is not a number`);
         }
         const n = Math.pow(10, decimals);
         return Math.floor(Number(num) * n) / n;
@@ -4122,15 +4122,16 @@
     function urlToFile(url) {
         return new Promise((resolve, reject) => {
             try {
-                window.fetch(url).then((res) => {
-                    if (res.status === 200) {
-                        res.blob().then((blob) => {
-                            blobToFile(blob).then((file) => {
-                                resolve(file);
+                window &&
+                    window.fetch(url).then((res) => {
+                        if (res.status === 200) {
+                            res.blob().then((blob) => {
+                                blobToFile(blob).then((file) => {
+                                    resolve(file);
+                                });
                             });
-                        });
-                    }
-                });
+                        }
+                    });
             }
             catch (err) {
                 console.error(err);
@@ -4407,7 +4408,7 @@
         });
         const rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
         if (!rgb) {
-            throw new Error(`Invalid hex color: ${hex}`);
+            throw new TypeError(`hexToRgb: invalid hex color: ${hex}`);
         }
         color.r = parseInt(rgb[1], 16);
         color.g = parseInt(rgb[2], 16);
@@ -4428,7 +4429,7 @@
         });
         const rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
         if (!rgb) {
-            throw new Error(`Invalid hex color: ${hex}`);
+            throw new TypeError(`hexToRgba: invalid hex color: ${hex}`);
         }
         color.r = parseInt(rgb[1], 16);
         color.g = parseInt(rgb[2], 16);
@@ -4449,7 +4450,7 @@
         });
         const rgb = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hexStr);
         if (!rgb) {
-            throw new Error(`Invalid hex color: ${hex}`);
+            throw new TypeError(`hexToHsl: invalid hex color: ${hex}`);
         }
         // 再组装为hsl格式
         const r = parseInt(rgb[1], 16) / 255;
@@ -4990,7 +4991,7 @@
      */
     const fromUint8Array = function (uint8Array, urlSafe = false) {
         if (!(uint8Array instanceof Uint8Array)) {
-            throw new TypeError("fromUint8Array方法仅支持Uint8Array输入");
+            throw new TypeError("fromUint8Array: input must be Uint8Array");
         }
         const bytes = Array.from(uint8Array);
         let result = bytesToBase64Chars(bytes);
@@ -5007,7 +5008,7 @@
      */
     const toUint8Array = function (base64Str, urlSafe = false) {
         if (typeof base64Str !== "string") {
-            throw new TypeError("toUint8Array方法仅支持字符串输入");
+            throw new TypeError("toUint8Array: input must be string");
         }
         // 处理URL安全字符
         if (urlSafe) {
@@ -5024,7 +5025,7 @@
      */
     const fromHex = function (hexStr, urlSafe = false) {
         if (typeof hexStr !== "string" || !/^[0-9a-fA-F]+$/.test(hexStr)) {
-            throw new TypeError("fromHex方法仅支持十六进制字符串输入");
+            throw new TypeError("fromHex: input must be hex string");
         }
         // 补全偶数长度
         const str = hexStr.length % 2 ? `0${hexStr}` : hexStr;
@@ -5046,7 +5047,7 @@
      */
     const toHex = function (base64Str, urlSafe = false) {
         if (typeof base64Str !== "string") {
-            throw new TypeError("toHex方法仅支持字符串输入");
+            throw new TypeError("toHex: input must be string");
         }
         // 处理URL安全字符
         if (urlSafe) {
@@ -5566,7 +5567,7 @@
      */
     function md5Hmac(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("md5Hmac: missing str or key");
         }
         return md5$1(str, key, false);
     }
@@ -5578,7 +5579,7 @@
      */
     function md5HmacRaw(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("md5HmacRaw: missing str or key");
         }
         return md5$1(str, key, true);
     }
@@ -6155,7 +6156,7 @@
      */
     function sha256Hmac(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("sha256Hmac: missing str or key");
         }
         return sha256_hmac(key, str);
     }
@@ -6167,7 +6168,7 @@
      */
     function sha256HmacRaw(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("sha256HmacRaw: missing str or key");
         }
         return sha256_hmac_raw(key, str);
     }
@@ -6196,7 +6197,7 @@
      */
     function sha224Hmac(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("sha224Hmac: missing str or key");
         }
         return sha224_hmac(key, str);
     }
@@ -6208,7 +6209,7 @@
      */
     function sha224HmacRaw(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("sha224HmacRaw: missing str or key");
         }
         return sha224_hmac_raw(key, str);
     }
@@ -6298,7 +6299,7 @@
             }
             else {
                 arr.push(point);
-                throw new Error("input is not supported");
+                throw new TypeError("utf8ToArray: input is not supported in sm3");
             }
         }
         return arr;
@@ -6425,7 +6426,7 @@
      */
     function sm3EncryptHmac(str, key) {
         if (!str || !key) {
-            throw new Error("Missing str or key");
+            throw new TypeError("sm3EncryptHmac: missing str or key");
         }
         return encrypt$1(str, key);
     }
@@ -6480,7 +6481,7 @@
     function hexToUint8Array(str) {
         str = str.replace(/\s+/g, ""); // 去除空格
         if (str.length % 2 !== 0)
-            throw new Error("Hex string length must be even");
+            throw new TypeError("hexToUint8Array: hex string length must be even from sm4");
         const arr = new Uint8Array(str.length / 2);
         for (let i = 0; i < str.length; i += 2) {
             arr[i / 2] = parseInt(str.substr(i, 2), 16) & 0xff;
@@ -6542,7 +6543,7 @@
                 return hexToUint8Array(input);
             }
         }
-        throw new Error(`Unsupported input type: ${typeof input}`);
+        throw new TypeError(`normalizeInput: unsupported input type: ${typeof input} from sm4`);
     }
     /**
      * 标准化密钥/IV为Uint8Array
@@ -6566,10 +6567,10 @@
             arr = new Uint8Array(keyOrIv);
         }
         else {
-            throw new Error(`Unsupported ${name} type: ${typeof keyOrIv}`);
+            throw new TypeError(`normalizeKeyIv: unsupported ${name} type: ${typeof keyOrIv} from sm4`);
         }
         if (arr.length !== expectedLength) {
-            throw new Error(`${name} must be ${expectedLength * 8} bits (${expectedLength} bytes)`);
+            throw new TypeError(`normalizeKeyIv: ${name} must be ${expectedLength * 8} bits (${expectedLength} bytes) from sm4`);
         }
         return arr;
     }
@@ -6621,7 +6622,7 @@
     function sm4BlockCrypt(inputBlock, outputBlock, roundKeys) {
         // 确保输入块是16字节
         if (inputBlock.length !== BLOCK_SIZE) {
-            throw new Error(`Input block must be ${BLOCK_SIZE} bytes for SM4 block crypt`);
+            throw new TypeError(`sm4BlockCrypt: input block must be ${BLOCK_SIZE} bytes for block crypt from sm4`);
         }
         // 字节数组转32比特字数组（4个字，共128比特）
         const x = new Uint32Array(4);
@@ -6716,7 +6717,7 @@
         // 验证填充合法性
         for (let i = 1; i <= paddingCount; i++) {
             if (data[data.length - i] !== paddingCount) {
-                throw new Error("Invalid PKCS#7 padding");
+                throw new TypeError("pkcs7Unpad: invalid PKCS#7 padding from sm4");
             }
         }
         return data.subarray(0, data.length - paddingCount);
@@ -6739,7 +6740,7 @@
          } = options;
         // 校验模式
         if (![SM4_MODE_ECB, SM4_MODE_CBC].includes(mode)) {
-            throw new Error(`Unsupported mode: ${mode}, only 'ecb' and 'cbc' are supported`);
+            throw new TypeError(`sm4Core: unsupported mode: ${mode}, only 'ecb' and 'cbc' are supported from sm4`);
         }
         // 标准化输入、密钥、IV
         const input = normalizeInput(inputData, cryptFlag);
@@ -6754,7 +6755,7 @@
             processedInput = pkcs7Pad(input);
             // 确保填充后是16字节的倍数
             if (processedInput.length % BLOCK_SIZE !== 0) {
-                throw new Error("PKCS7 padding failed: data length is not multiple of block size");
+                throw new TypeError("sm4Core: PKCS7 padding failed: data length is not multiple of block size from sm4");
             }
         }
         // 生成轮密钥
@@ -6814,7 +6815,7 @@
             case SM4_OUTPUT_ARRAYBUFFER:
                 return finalOutput.buffer;
             default:
-                throw new Error(`Unsupported output format: ${output}`);
+                throw new TypeError(`sm4Core: unsupported output format: ${output} from sm4`);
         }
     }
     // ========== 便捷API（函数式，符合设计准则） ==========
@@ -6826,7 +6827,7 @@
     function generateIv(outputFormat = SM4_OUTPUT_HEX) {
         // 1. 校验浏览器是否支持 crypto
         if (!window?.crypto?.getRandomValues) {
-            throw new Error("Your browser does not support secure random generation (crypto API)");
+            throw new TypeError("generateIv: your browser does not support secure random generation (crypto API) from sm4");
         }
         // 2. 生成 16 字节安全随机数
         const ivUint8 = new Uint8Array(IV_SIZE);
@@ -6857,7 +6858,7 @@
     function generateKey(outputFormat = SM4_OUTPUT_HEX) {
         // 校验浏览器/Node环境的安全随机数API
         if (!window?.crypto?.getRandomValues && !global?.crypto?.getRandomValues) {
-            throw new Error("当前环境不支持安全随机数生成，请升级浏览器/Node.js");
+            throw new TypeError("generateKey: the current environment does not support secure random number generation. please upgrade your browser/Node.js from sm4");
         }
         // 生成16字节随机数（SM4密钥固定16字节）
         const cryptoObj = window?.crypto || global?.crypto;
@@ -6963,15 +6964,15 @@
         // 1. 校验模式是否合法
         const validModes = Object.values(MODE);
         if (!validModes.includes(mode)) {
-            throw new Error(`sm4${operation} 方法错误：不支持的加密模式 "${mode}"，仅支持 ${validModes.join("/")}`);
+            throw new TypeError(`sm4${operation}：unsupported encryption mode "${mode}", supports only ${validModes.join("/")}`);
         }
         // 2. CBC模式必须传IV
         if (mode === MODE.CBC && !iv) {
-            throw new Error(`sm4${operation} 方法错误：CBC 模式必须传入 IV 初始向量`);
+            throw new TypeError(`sm4${operation}：the CBC mode must be inputted with an IV (initialization vector)`);
         }
         // 3. ECB模式禁止传IV（避免误用）
         if (mode === MODE.ECB && iv !== undefined) {
-            throw new Error(`sm4${operation} 方法错误：ECB 模式不需要传入 IV，请勿传递iv参数`);
+            throw new TypeError(`sm4${operation}: the ECB mode does not require an IV to be passed in. Please do not pass the iv parameter`);
         }
         // 4. 校验IV长度（如果传了IV）
         if (iv) {
@@ -6993,12 +6994,12 @@
                 ivLength = 0;
             }
             if (ivLength !== 16) {
-                throw new Error(`SM4${operation}错误：IV 长度必须为 16 字节，当前长度为 ${ivLength}`);
+                throw new TypeError(`sm4${operation}：IV must be 16 bytes in length, and the current length is ${ivLength}`);
             }
         }
         // 5. 校验填充模式（仅允许pkcs#7）
         if (options.padding && options.padding !== String(PADDING)) {
-            throw new Error(`SM4${operation}错误：仅支持 pkcs#7 填充模式，当前传入 ${String(options.padding)}`);
+            throw new TypeError(`sm4${operation}: only pkcs#7 padding mode is supported, currently being input ${String(options.padding)}`);
         }
     }
     // sm4的配置
@@ -7614,7 +7615,7 @@
      * @returns {string} 返回数据
      */
     function getLocalStorage(key) {
-        return window.localStorage.getItem(key) || undefined;
+        return (window && window.localStorage.getItem(key)) || undefined;
     }
     /**
      * 设置localStorage缓存数据
@@ -7622,20 +7623,20 @@
      * @param {string} value value值
      */
     function setLocalStorage(key, value) {
-        window.localStorage.setItem(key, value);
+        window && window.localStorage.setItem(key, value);
     }
     /**
      * 通过key从localStorage缓存中删除数据
      * @param {string} key key值
      */
     function removeLocalStorage(key) {
-        window.localStorage.removeItem(key);
+        window && window.localStorage.removeItem(key);
     }
     /**
      * 清空localStorage缓存中所有数据
      */
     function clearLocalStorage() {
-        window.localStorage.clear();
+        window && window.localStorage.clear();
     }
 
     /* sessionStorage存储 */
@@ -7645,7 +7646,7 @@
      * @returns {string} 返回数据
      */
     function getSessionStorage(key) {
-        return window.sessionStorage.getItem(key) || undefined;
+        return (window && window.sessionStorage.getItem(key)) || undefined;
     }
     /**
      * 设置sessionStorage缓存数据
@@ -7653,20 +7654,20 @@
      * @param {string} value value值
      */
     function setSessionStorage(key, value) {
-        window.sessionStorage.setItem(key, value);
+        window && window.sessionStorage.setItem(key, value);
     }
     /**
      * 通过key从sessionStorage缓存中删除数据
      * @param {string} key key值
      */
     function removeSessionStorage(key) {
-        window.sessionStorage.removeItem(key);
+        window && window.sessionStorage.removeItem(key);
     }
     /**
      * 清空sessionStorage缓存中所有数据
      */
     function clearSessionStorage() {
-        window.sessionStorage.clear();
+        window && window.sessionStorage.clear();
     }
 
     /**
@@ -7811,7 +7812,7 @@
      * @returns {Object} 返回浏览器信息
      */
     function getBrowserInfo() {
-        const ua = window.navigator.userAgent.toLowerCase();
+        const ua = window && window.navigator.userAgent.toLowerCase();
         // ie
         const ie = ua.match(/rv:([\d.]+)\) like gecko/) || ua.match(/msie ([\d\.]+)/);
         // edge
@@ -7854,7 +7855,7 @@
      * @returns {boolean} 返回true和false
      */
     function isPhone() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /Android|webOS|iPhone|iPod|BlackBerry|Windows Phone|IEMobile/i.test(ua);
     }
     /* 操作系统类型 */
@@ -7863,7 +7864,7 @@
      * @returns {boolean} 返回true和false
      */
     function isAndroid() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /Android|BlackBerry/i.test(ua);
     }
     /**
@@ -7871,7 +7872,7 @@
      * @returns {boolean} 返回true和false
      */
     function isIos() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /iPhone|iPad|iPod|iOS/i.test(ua);
     }
     /**
@@ -7879,7 +7880,7 @@
      * @returns {boolean} 返回true和false
      */
     function isWindowsPhone() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /Windows Phone/i.test(ua);
     }
     /**
@@ -7887,7 +7888,7 @@
      * @returns {boolean} 返回true和false
      */
     function isWindows() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /win/i.test(ua);
     }
     /**
@@ -7895,7 +7896,7 @@
      * @returns {boolean} 返回true和false
      */
     function isLinux() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /linux/i.test(ua);
     }
     /**
@@ -7903,7 +7904,7 @@
      * @returns {boolean} 返回true和false
      */
     function isMac() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /mac/i.test(ua);
     }
     /* 苹果设备类型 */
@@ -7912,7 +7913,7 @@
      *@returns {boolean} 返回true和false
      */
     function isIphone() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /iPhone/i.test(ua);
     }
     /**
@@ -7920,7 +7921,7 @@
      *@return {boolean} 返回true和false
      */
     function isIpad() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /iPod/i.test(ua);
     }
     /* 手机浏览器类型 */
@@ -7929,7 +7930,7 @@
      * @returns {boolean} 返回true和false
      */
     function isWeixin() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /MicroMessenger/i.test(ua);
     }
     /**
@@ -7937,7 +7938,7 @@
      * @returns {boolean} 返回true和false
      */
     function isQQ() {
-        const ua = window.navigator.userAgent;
+        const ua = window && window.navigator.userAgent;
         return /QQ/i.test(ua);
     }
 
@@ -7983,7 +7984,7 @@
      */
     function getClipboardText() {
         return new Promise((resolve, reject) => {
-            if (window.navigator.clipboard) {
+            if (window && window.navigator) {
                 window.navigator.clipboard
                     .readText()
                     .then((text) => {
@@ -8007,7 +8008,7 @@
     function setClipboard(data) {
         return new Promise((resolve, reject) => {
             // 现代浏览器
-            if (window.navigator.clipboard) {
+            if (window && window.navigator) {
                 let clipboardItem = null;
                 // 是文本类型
                 if (typeof data === "string") {
@@ -8040,7 +8041,7 @@
     function setClipboardText(text) {
         return new Promise((resolve, reject) => {
             // 现代浏览器
-            if (window.navigator.clipboard) {
+            if (window && window.navigator) {
                 window.navigator.clipboard.writeText(text).then((success) => {
                     resolve(true);
                 }, (failed) => {