@i17hush/h5-utils 1.1.1 → 1.1.2

package/dist/index.cjs.js

@@ -221,15 +221,36 @@ function createTaroAdapter(taro) {
 }
 
 let currentAdapter = null;
+/**
+ * 运行时检测是否在 Taro 环境中
+ * 不依赖 process.env.TARO_ENV（构建时替换，预编译库无法获取）
+ * 改为检测 Taro 运行时特征
+ */
+function isTaroEnv() {
+    // 1. 检测小程序全局对象（微信 wx、支付宝 my、字节 tt、百度 swan、QQ qq）
+    if (typeof wx !== 'undefined' ||
+        typeof my !== 'undefined' ||
+        typeof tt !== 'undefined' ||
+        typeof swan !== 'undefined' ||
+        typeof qq !== 'undefined') {
+        return true;
+    }
+    // 2. 检测 Taro 运行时注入的全局变量
+    const g = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : {};
+    if (g.__TARO || g.__taro__) {
+        return true;
+    }
+    // 3. process.env.TARO_ENV 作为补充（Taro H5 模式下可能有效）
+    if (typeof process !== 'undefined' && process.env && process.env.TARO_ENV) {
+        return true;
+    }
+    return false;
+}
 /**
  * 自动检测运行环境并创建对应适配器
  */
 function detectAdapter() {
-    // Taro 构建时会注入 process.env.TARO_ENV（如 'weapp', 'h5', 'alipay' 等）
-    const env = typeof process !== 'undefined' && process.env
-        ? process.env.TARO_ENV
-        : '';
-    if (env) {
+    if (isTaroEnv()) {
         try {
             // eslint-disable-next-line @typescript-eslint/no-var-requires
             const Taro = require('@tarojs/taro');
@@ -257,6 +278,35 @@ function setAdapter(adapter) {
     currentAdapter = adapter;
 }
 
+/**
+ * 内部错误处理工具
+ */
+const PREFIX = '[h5-utils]';
+/**
+ * 安全执行函数，出错时打印错误并返回默认值
+ */
+function safeCall(fn, fallback, method) {
+    try {
+        return fn();
+    }
+    catch (e) {
+        console.error(`${PREFIX} ${method} error:`, (e === null || e === void 0 ? void 0 : e.message) || e);
+        return fallback;
+    }
+}
+/**
+ * 安全执行异步函数
+ */
+async function safeCallAsync(fn, fallback, method) {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        console.error(`${PREFIX} ${method} error:`, (e === null || e === void 0 ? void 0 : e.message) || e);
+        return fallback;
+    }
+}
+
 /**
  * URL 解析与操作工具
  */
@@ -264,57 +314,63 @@ function setAdapter(adapter) {
  * 解析 URL 为结构化对象
  */
 function parseUrl(url) {
-    const a = document.createElement('a');
-    a.href = url;
-    const query = {};
-    if (a.search) {
-        a.search
-            .slice(1)
-            .split('&')
-            .forEach((pair) => {
-            const [key, val] = pair.split('=');
-            if (key)
-                query[decodeURIComponent(key)] = decodeURIComponent(val || '');
-        });
-    }
-    return {
-        protocol: a.protocol,
-        host: a.host,
-        port: a.port,
-        pathname: a.pathname,
-        search: a.search,
-        hash: a.hash,
-        query,
-    };
+    return safeCall(() => {
+        const a = document.createElement('a');
+        a.href = url;
+        const query = {};
+        if (a.search) {
+            a.search
+                .slice(1)
+                .split('&')
+                .forEach((pair) => {
+                const [key, val] = pair.split('=');
+                if (key)
+                    query[decodeURIComponent(key)] = decodeURIComponent(val || '');
+            });
+        }
+        return {
+            protocol: a.protocol,
+            host: a.host,
+            port: a.port,
+            pathname: a.pathname,
+            search: a.search,
+            hash: a.hash,
+            query,
+        };
+    }, { protocol: '', host: '', port: '', pathname: '', search: '', hash: '', query: {} }, 'parseUrl');
 }
 /**
  * 拼接带查询参数的 URL
  */
 function buildUrl(base, params) {
-    const search = Object.entries(params)
-        .filter(([, v]) => v !== undefined && v !== null)
-        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
-        .join('&');
-    if (!search)
-        return base;
-    const separator = base.includes('?') ? '&' : '?';
-    return `${base}${separator}${search}`;
+    return safeCall(() => {
+        const search = Object.entries(params)
+            .filter(([, v]) => v !== undefined && v !== null)
+            .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)
+            .join('&');
+        if (!search)
+            return base;
+        const separator = base.includes('?') ? '&' : '?';
+        return `${base}${separator}${search}`;
+    }, base, 'buildUrl');
 }
 /**
  * 获取当前页面指定查询参数
  */
 function getQueryParam(name) {
-    return new URLSearchParams(window.location.search).get(name);
+    return safeCall(() => new URLSearchParams(window.location.search).get(name), null, 'getQueryParam');
 }
 /**
  * 获取当前页面所有查询参数
  */
 function getAllQueryParams() {
-    const params = {};
-    new URLSearchParams(window.location.search).forEach((value, key) => {
-        params[key] = value;
-    });
-    return params;
+    return safeCall(() => {
+        const params = {};
+        new URLSearchParams(window.location.search).forEach((value, key) => {
+            params[key] = value;
+        });
+        return params;
+    }, {}, 'getAllQueryParams');
 }
 
 /**
@@ -326,42 +382,46 @@ function getAllQueryParams() {
  * 获取存储值，支持 JSON 自动反序列化
  */
 function get$1(key) {
-    const raw = getAdapter().storage.get(key);
-    if (raw === null)
-        return null;
-    try {
-        const item = JSON.parse(raw);
-        if (item.expireAt !== null && Date.now() > item.expireAt) {
-            getAdapter().storage.remove(key);
+    return safeCall(() => {
+        const raw = getAdapter().storage.get(key);
+        if (raw === null)
             return null;
+        try {
+            const item = JSON.parse(raw);
+            if (item.expireAt !== null && Date.now() > item.expireAt) {
+                getAdapter().storage.remove(key);
+                return null;
+            }
+            return item.value;
         }
-        return item.value;
-    }
-    catch (_a) {
-        return raw;
-    }
+        catch (_a) {
+            return raw;
+        }
+    }, null, 'getStorage');
 }
 /**
  * 设置存储值，支持过期时间
  */
 function set$1(key, value, options) {
-    const item = {
-        value,
-        expireAt: (options === null || options === void 0 ? void 0 : options.expires) ? Date.now() + options.expires : null,
-    };
-    getAdapter().storage.set(key, JSON.stringify(item), options);
+    safeCall(() => {
+        const item = {
+            value,
+            expireAt: (options === null || options === void 0 ? void 0 : options.expires) ? Date.now() + options.expires : null,
+        };
+        getAdapter().storage.set(key, JSON.stringify(item), options);
+    }, undefined, 'setStorage');
 }
 /**
  * 删除存储值
  */
 function remove$1(key) {
-    getAdapter().storage.remove(key);
+    safeCall(() => getAdapter().storage.remove(key), undefined, 'removeStorage');
 }
 /**
  * 清空所有存储
  */
 function clear() {
-    getAdapter().storage.clear();
+    safeCall(() => getAdapter().storage.clear(), undefined, 'clearStorage');
 }
 
 /**
@@ -371,27 +431,31 @@ function clear() {
  * 获取 Cookie 值
  */
 function get(name) {
-    const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${encodeURIComponent(name)}=([^;]*)`));
-    return match ? decodeURIComponent(match[1]) : null;
+    return safeCall(() => {
+        const match = document.cookie.match(new RegExp(`(?:^|;\\s*)${encodeURIComponent(name)}=([^;]*)`));
+        return match ? decodeURIComponent(match[1]) : null;
+    }, null, 'getCookie');
 }
 /**
  * 设置 Cookie
  */
 function set(name, value, options = {}) {
-    const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];
-    if (options.days) {
-        const expires = new Date(Date.now() + options.days * 864e5).toUTCString();
-        parts.push(`expires=${expires}`);
-    }
-    if (options.path)
-        parts.push(`path=${options.path}`);
-    if (options.domain)
-        parts.push(`domain=${options.domain}`);
-    if (options.secure)
-        parts.push('secure');
-    if (options.sameSite)
-        parts.push(`samesite=${options.sameSite}`);
-    document.cookie = parts.join('; ');
+    safeCall(() => {
+        const parts = [`${encodeURIComponent(name)}=${encodeURIComponent(value)}`];
+        if (options.days) {
+            const expires = new Date(Date.now() + options.days * 864e5).toUTCString();
+            parts.push(`expires=${expires}`);
+        }
+        if (options.path)
+            parts.push(`path=${options.path}`);
+        if (options.domain)
+            parts.push(`domain=${options.domain}`);
+        if (options.secure)
+            parts.push('secure');
+        if (options.sameSite)
+            parts.push(`samesite=${options.sameSite}`);
+        document.cookie = parts.join('; ');
+    }, undefined, 'setCookie');
 }
 /**
  * 删除 Cookie
@@ -407,60 +471,73 @@ function remove(name, options = {}) {
  * 是否为 iOS
  */
 function isIOS() {
-    return getAdapter().device.getInfo().ios;
+    return safeCall(() => getAdapter().device.getInfo().ios, false, 'isIOS');
 }
 /**
  * 是否为 Android
  */
 function isAndroid() {
-    return getAdapter().device.getInfo().android;
+    return safeCall(() => getAdapter().device.getInfo().android, false, 'isAndroid');
 }
 /**
  * 是否为微信浏览器
  */
 function isWeChat() {
-    return getAdapter().device.getInfo().weChat;
+    return safeCall(() => getAdapter().device.getInfo().weChat, false, 'isWeChat');
 }
 /**
  * 是否为移动端
  */
 function isMobile() {
-    return getAdapter().device.getInfo().mobile;
+    return safeCall(() => getAdapter().device.getInfo().mobile, false, 'isMobile');
 }
 /**
  * 获取浏览器类型（H5 专用）
  */
 function getBrowserType() {
-    const ua = typeof navigator !== 'undefined' ? navigator.userAgent : '';
-    if (/MicroMessenger/i.test(ua))
-        return 'weixin';
-    if (/\bQQ\//i.test(ua))
-        return 'qq';
-    if (/UCBrowser/i.test(ua))
-        return 'uc';
-    if (/Edg/i.test(ua))
-        return 'edge';
-    if (/Firefox/i.test(ua))
-        return 'firefox';
-    if (/MSIE|Trident/i.test(ua))
-        return 'ie';
-    if (/Chrome/i.test(ua))
-        return 'chrome';
-    if (/Safari/i.test(ua))
-        return 'safari';
-    return 'unknown';
+    return safeCall(() => {
+        const ua = typeof navigator !== 'undefined' ? navigator.userAgent : '';
+        if (/MicroMessenger/i.test(ua))
+            return 'weixin';
+        if (/\bQQ\//i.test(ua))
+            return 'qq';
+        if (/UCBrowser/i.test(ua))
+            return 'uc';
+        if (/Edg/i.test(ua))
+            return 'edge';
+        if (/Firefox/i.test(ua))
+            return 'firefox';
+        if (/MSIE|Trident/i.test(ua))
+            return 'ie';
+        if (/Chrome/i.test(ua))
+            return 'chrome';
+        if (/Safari/i.test(ua))
+            return 'safari';
+        return 'unknown';
+    }, 'unknown', 'getBrowserType');
 }
 /**
  * 获取操作系统信息
  */
 function getOS() {
-    return getAdapter().device.getInfo().os;
+    return safeCall(() => getAdapter().device.getInfo().os, 'Unknown', 'getOS');
 }
 /**
  * 获取完整设备信息
  */
 function getDeviceInfo() {
-    return getAdapter().device.getInfo();
+    return safeCall(() => getAdapter().device.getInfo(), {
+        ios: false,
+        android: false,
+        mobile: false,
+        weChat: false,
+        os: 'Unknown',
+        brand: '',
+        model: '',
+        screenWidth: 0,
+        screenHeight: 0,
+        pixelRatio: 1,
+    }, 'getDeviceInfo');
 }
 
 /**
@@ -470,53 +547,56 @@ function getDeviceInfo() {
  * 查询单个元素
  */
 function $(selector) {
-    return getAdapter().dom.select(selector);
+    return safeCall(() => getAdapter().dom.select(selector), null, '$');
 }
 /**
  * 查询多个元素
  */
 function $$(selector) {
-    return getAdapter().dom.selectAll(selector);
+    return safeCall(() => getAdapter().dom.selectAll(selector), [], '$$');
 }
 /**
  * 添加 class
  */
 function addClass(el, cls) {
-    el.classList.add(cls);
+    safeCall(() => el.classList.add(cls), undefined, 'addClass');
 }
 /**
  * 移除 class
  */
 function removeClass(el, cls) {
-    el.classList.remove(cls);
+    safeCall(() => el.classList.remove(cls), undefined, 'removeClass');
 }
 /**
  * 切换 class
  */
 function toggleClass(el, cls) {
-    el.classList.toggle(cls);
+    safeCall(() => el.classList.toggle(cls), undefined, 'toggleClass');
 }
 /**
  * 判断是否包含 class
  */
 function hasClass(el, cls) {
-    return el.classList.contains(cls);
+    return safeCall(() => el.classList.contains(cls), false, 'hasClass');
 }
 /**
  * 获取元素样式
  */
 function getStyle(el, prop) {
-    return (el.style.getPropertyValue(prop) || getComputedStyle(el).getPropertyValue(prop));
+    return safeCall(() => el.style.getPropertyValue(prop) ||
+        getComputedStyle(el).getPropertyValue(prop), '', 'getStyle');
 }
 /**
  * 判断元素是否在可视区域内
  */
 function isInViewport(el) {
-    const rect = el.getBoundingClientRect();
-    return (rect.top >= 0 &&
-        rect.left >= 0 &&
-        rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
-        rect.right <= (window.innerWidth || document.documentElement.clientWidth));
+    return safeCall(() => {
+        const rect = el.getBoundingClientRect();
+        return (rect.top >= 0 &&
+            rect.left >= 0 &&
+            rect.bottom <= (window.innerHeight || document.documentElement.clientHeight) &&
+            rect.right <= (window.innerWidth || document.documentElement.clientWidth));
+    }, false, 'isInViewport');
 }
 
 /**
@@ -526,19 +606,19 @@ function isInViewport(el) {
  * 绑定事件
  */
 function on(el, event, handler, options) {
-    el.addEventListener(event, handler, options);
+    safeCall(() => el.addEventListener(event, handler, options), undefined, 'on');
 }
 /**
  * 解绑事件
  */
 function off(el, event, handler, options) {
-    el.removeEventListener(event, handler, options);
+    safeCall(() => el.removeEventListener(event, handler, options), undefined, 'off');
 }
 /**
  * 单次监听事件
  */
 function once(el, event, handler) {
-    el.addEventListener(event, handler, { once: true });
+    safeCall(() => el.addEventListener(event, handler, { once: true }), undefined, 'once');
 }
 /**
  * 事件委托
@@ -548,14 +628,16 @@ function once(el, event, handler) {
  * @param handler 回调函数
  */
 function delegate(parent, selector, event, handler) {
-    const wrappedHandler = (e) => {
-        var _a;
-        const target = (_a = e.target) === null || _a === void 0 ? void 0 : _a.closest(selector);
-        if (target) {
-            handler(target, e);
-        }
-    };
-    parent.addEventListener(event, wrappedHandler);
+    safeCall(() => {
+        const wrappedHandler = (e) => {
+            var _a;
+            const target = (_a = e.target) === null || _a === void 0 ? void 0 : _a.closest(selector);
+            if (target) {
+                handler(target, e);
+            }
+        };
+        parent.addEventListener(event, wrappedHandler);
+    }, undefined, 'delegate');
 }
 
 /**
@@ -565,13 +647,13 @@ function delegate(parent, selector, event, handler) {
  * 复制文本到剪贴板
  */
 function copyText(text) {
-    return getAdapter().clipboard.write(text);
+    return safeCallAsync(() => getAdapter().clipboard.write(text), undefined, 'copyText');
 }
 /**
  * 读取剪贴板文本
  */
 function readText() {
-    return getAdapter().clipboard.read();
+    return safeCallAsync(() => getAdapter().clipboard.read(), '', 'readText');
 }
 
 /**
@@ -582,34 +664,40 @@ let scrollLockCount = 0;
  * 滚动到页面顶部
  */
 function scrollToTop(smooth = true) {
-    getAdapter().scroll.scrollTo({ top: 0, animated: smooth });
+    safeCall(() => getAdapter().scroll.scrollTo({ top: 0, animated: smooth }), undefined, 'scrollToTop');
 }
 /**
  * 滚动到指定元素
  */
 function scrollToElement(el, options = {}) {
-    const { offset = 0, smooth = true } = options;
-    const rect = el.getBoundingClientRect();
-    const top = window.scrollY + rect.top + offset;
-    getAdapter().scroll.scrollTo({ top, animated: smooth });
+    safeCall(() => {
+        const { offset = 0, smooth = true } = options;
+        const rect = el.getBoundingClientRect();
+        const top = window.scrollY + rect.top + offset;
+        getAdapter().scroll.scrollTo({ top, animated: smooth });
+    }, undefined, 'scrollToElement');
 }
 /**
  * 锁定页面滚动
  */
 function lockScroll() {
-    scrollLockCount++;
-    if (scrollLockCount === 1) {
-        getAdapter().scroll.lockScroll();
-    }
+    safeCall(() => {
+        scrollLockCount++;
+        if (scrollLockCount === 1) {
+            getAdapter().scroll.lockScroll();
+        }
+    }, undefined, 'lockScroll');
 }
 /**
  * 解锁页面滚动
  */
 function unlockScroll() {
-    scrollLockCount = Math.max(0, scrollLockCount - 1);
-    if (scrollLockCount === 0) {
-        getAdapter().scroll.unlockScroll();
-    }
+    safeCall(() => {
+        scrollLockCount = Math.max(0, scrollLockCount - 1);
+        if (scrollLockCount === 0) {
+            getAdapter().scroll.unlockScroll();
+        }
+    }, undefined, 'unlockScroll');
 }
 
 /**
@@ -620,49 +708,53 @@ function unlockScroll() {
  * @example formatDate(new Date(), 'YYYY-MM-DD HH:mm:ss')
  */
 function formatDate(date, fmt = 'YYYY-MM-DD HH:mm:ss') {
-    const d = new Date(date);
-    const map = {
-        YYYY: String(d.getFullYear()),
-        MM: String(d.getMonth() + 1).padStart(2, '0'),
-        DD: String(d.getDate()).padStart(2, '0'),
-        HH: String(d.getHours()).padStart(2, '0'),
-        mm: String(d.getMinutes()).padStart(2, '0'),
-        ss: String(d.getSeconds()).padStart(2, '0'),
-    };
-    let result = fmt;
-    for (const [key, val] of Object.entries(map)) {
-        result = result.replace(key, val);
-    }
-    return result;
+    return safeCall(() => {
+        const d = new Date(date);
+        const map = {
+            YYYY: String(d.getFullYear()),
+            MM: String(d.getMonth() + 1).padStart(2, '0'),
+            DD: String(d.getDate()).padStart(2, '0'),
+            HH: String(d.getHours()).padStart(2, '0'),
+            mm: String(d.getMinutes()).padStart(2, '0'),
+            ss: String(d.getSeconds()).padStart(2, '0'),
+        };
+        let result = fmt;
+        for (const [key, val] of Object.entries(map)) {
+            result = result.replace(key, val);
+        }
+        return result;
+    }, '', 'formatDate');
 }
 /**
  * 数字格式化（千分位等）
  */
 function formatNumber(num, options = {}) {
-    const { precision, separator = ',' } = options;
-    let str = precision !== undefined ? num.toFixed(precision) : String(num);
-    const [intPart, decPart] = str.split('.');
-    const formatted = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
-    return decPart !== undefined ? `${formatted}.${decPart}` : formatted;
+    return safeCall(() => {
+        const { precision, separator = ',' } = options;
+        let str = precision !== undefined ? num.toFixed(precision) : String(num);
+        const [intPart, decPart] = str.split('.');
+        const formatted = intPart.replace(/\B(?=(\d{3})+(?!\d))/g, separator);
+        return decPart !== undefined ? `${formatted}.${decPart}` : formatted;
+    }, String(num), 'formatNumber');
 }
 /**
  * 手机号格式化 (xxx xxxx xxxx)
  */
 function formatPhone(phone) {
-    return phone.replace(/(\d{3})(\d{0,4})(\d{0,4})/, (_, a, b, c) => {
+    return safeCall(() => phone.replace(/(\d{3})(\d{0,4})(\d{0,4})/, (_, a, b, c) => {
         let result = a;
         if (b)
             result += ` ${b}`;
         if (c)
             result += ` ${c}`;
         return result;
-    });
+    }), phone, 'formatPhone');
 }
 /**
  * 金额格式化
  */
 function formatMoney(amount, precision = 2) {
-    return formatNumber(amount, { precision });
+    return safeCall(() => formatNumber(amount, { precision }), String(amount), 'formatMoney');
 }
 /**
  * 节流
@@ -673,7 +765,12 @@ function throttle(fn, delay) {
         const now = Date.now();
         if (now - last >= delay) {
             last = now;
-            fn.apply(this, args);
+            try {
+                fn.apply(this, args);
+            }
+            catch (e) {
+                console.error('[h5-utils] throttle error:', (e === null || e === void 0 ? void 0 : e.message) || e);
+            }
         }
     };
 }
@@ -685,7 +782,14 @@ function debounce(fn, delay) {
     return function (...args) {
         if (timer)
             clearTimeout(timer);
-        timer = setTimeout(() => fn.apply(this, args), delay);
+        timer = setTimeout(() => {
+            try {
+                fn.apply(this, args);
+            }
+            catch (e) {
+                console.error('[h5-utils] debounce error:', (e === null || e === void 0 ? void 0 : e.message) || e);
+            }
+        }, delay);
     };
 }
 
@@ -703,40 +807,41 @@ const patterns = {
  * 手机号格式校验
  */
 function isMobilePhone(str) {
-    return patterns.mobile.test(str);
+    return safeCall(() => patterns.mobile.test(str), false, 'isMobilePhone');
 }
 /**
  * 邮箱校验
  */
 function isEmail(str) {
-    return patterns.email.test(str);
+    return safeCall(() => patterns.email.test(str), false, 'isEmail');
 }
 /**
  * 身份证号校验（18位）
  */
 function isIdCard(str) {
-    if (!patterns.idCard.test(str))
-        return false;
-    // 校验位验证
-    const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
-    const checkCodes = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];
-    let sum = 0;
-    for (let i = 0; i < 17; i++) {
-        sum += parseInt(str[i], 10) * weights[i];
-    }
-    return checkCodes[sum % 11] === str[17].toUpperCase();
+    return safeCall(() => {
+        if (!patterns.idCard.test(str))
+            return false;
+        const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2];
+        const checkCodes = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2'];
+        let sum = 0;
+        for (let i = 0; i < 17; i++) {
+            sum += parseInt(str[i], 10) * weights[i];
+        }
+        return checkCodes[sum % 11] === str[17].toUpperCase();
+    }, false, 'isIdCard');
 }
 /**
  * URL 校验
  */
 function isUrl(str) {
-    return patterns.url.test(str);
+    return safeCall(() => patterns.url.test(str), false, 'isUrl');
 }
 /**
  * 中文校验
  */
 function isChinese(str) {
-    return patterns.chinese.test(str);
+    return safeCall(() => patterns.chinese.test(str), false, 'isChinese');
 }
 
 exports.$ = $;