@be-link/cls-logger 1.0.11 → 1.0.13

package/dist/mini/ClsLogger.d.ts

@@ -9,6 +9,12 @@ export declare class ClsLoggerMini extends ClsLoggerCore {
     protected installPerformanceMonitor(report: (type: string, data: FlatFields) => void, options: boolean | PerformanceMonitorOptions): void;
     protected installBehaviorMonitor(report: (type: string, data: FlatFields) => void, options: boolean | BehaviorMonitorOptions): () => void;
     protected createDeviceInfoBaseFields(options: boolean | DeviceInfoOptions | undefined): (() => FlatFields) | null;
+    /**
+     * 小程序版本的可见性监听
+     * - 监听 wx.onAppHide 在应用隐藏时发送日志
+     * - 确保用户关闭小程序或切后台时，队列中的日志不会丢失
+     */
+    protected setupVisibilityListener(): void;
     private normalize;
 }
 //# sourceMappingURL=ClsLogger.d.ts.map

package/dist/mini/ClsLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClsLogger.d.ts","sourceRoot":"","sources":["../../src/mini/ClsLogger.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMnD,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAS,CAAC,OAAO,EAAE,OAAO,UAAU,EAAE,OAAO,CAAiB;cAE9C,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAahD,SAAS,CAAC,qBAAqB,CAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,qBAAqB,GAC7B,IAAI;IAIP,SAAS,CAAC,mBAAmB,CAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,OAAO,GAAG,mBAAmB,GACrC,IAAI;IAIP,SAAS,CAAC,yBAAyB,CACjC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,OAAO,GAAG,yBAAyB,GAC3C,IAAI;IAIP,SAAS,CAAC,sBAAsB,CAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,OAAO,GAAG,sBAAsB,GACxC,MAAM,IAAI;IAIb,SAAS,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI;IAIjH,OAAO,CAAC,SAAS;CAYlB"}
+{"version":3,"file":"ClsLogger.d.ts","sourceRoot":"","sources":["../../src/mini/ClsLogger.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMnD,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,aAAa;IAC9C,SAAS,CAAC,OAAO,EAAE,OAAO,UAAU,EAAE,OAAO,CAAiB;cAE9C,OAAO,IAAI,OAAO,CAAC,YAAY,CAAC;IAahD,SAAS,CAAC,qBAAqB,CAC7B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,qBAAqB,GAC7B,IAAI;IAIP,SAAS,CAAC,mBAAmB,CAC3B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,OAAO,GAAG,mBAAmB,GACrC,IAAI;IAIP,SAAS,CAAC,yBAAyB,CACjC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,OAAO,GAAG,yBAAyB,GAC3C,IAAI;IAIP,SAAS,CAAC,sBAAsB,CAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,EAChD,OAAO,EAAE,OAAO,GAAG,sBAAsB,GACxC,MAAM,IAAI;IAIb,SAAS,CAAC,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI;IAIjH;;;;OAIG;IACH,SAAS,CAAC,uBAAuB,IAAI,IAAI;IAezC,OAAO,CAAC,SAAS;CAYlB"}

package/dist/mini/behaviorMonitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"behaviorMonitor.d.ts","sourceRoot":"","sources":["../../src/mini/behaviorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAU,MAAM,UAAU,CAAC;AAG3E,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AAsEzD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,IAAI,CA6N7G"}
+{"version":3,"file":"behaviorMonitor.d.ts","sourceRoot":"","sources":["../../src/mini/behaviorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAU,MAAM,UAAU,CAAC;AAG3E,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AAgFzD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAE,sBAA2B,GAAG,MAAM,IAAI,CA6N7G"}

package/dist/mini/deviceInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceInfo.d.ts","sourceRoot":"","sources":["../../src/mini/deviceInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAsE9D,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAC5C,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI,CAqC3B"}
+{"version":3,"file":"deviceInfo.d.ts","sourceRoot":"","sources":["../../src/mini/deviceInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAuE9D,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,GAC5C,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI,CAqC3B"}

package/dist/mini/errorMonitor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorMonitor.d.ts","sourceRoot":"","sources":["../../src/mini/errorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGhE,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AAoNzD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAE,OAAO,GAAG,mBAAmB,GAAG,SAAc,GAAG,IAAI,CAgBpH"}
+{"version":3,"file":"errorMonitor.d.ts","sourceRoot":"","sources":["../../src/mini/errorMonitor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGhE,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;AAkQzD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAE,OAAO,GAAG,mBAAmB,GAAG,SAAc,GAAG,IAAI,CAiBpH"}

package/dist/mini.esm.js

@@ -178,6 +178,11 @@ class ClsLoggerCore {
         this.batchTimerDueAt = null;
         this.initTs = 0;
         this.startupDelayMs = 0;
+        this.startupMaxSize = 0; // 启动窗口内的 maxSize，0 表示使用默认计算值
+        this.useIdleCallback = false;
+        this.idleTimeout = 3000;
+        this.pendingIdleCallback = null; // requestIdleCallback 的 id
+        this.visibilityCleanup = null;
         // 参考文档：失败缓存 + 重试
         this.failedCacheKey = 'cls_failed_logs';
         this.failedCacheMax = 200;
@@ -201,7 +206,7 @@ class ClsLoggerCore {
         }
         return 'browser';
     }
-    init(options) {
+    async init(options) {
         this.initTs = Date.now();
         const topicId = options?.tencentCloud?.topicID ?? options?.topic_id ?? options?.topicID ?? this.topicId;
         const endpoint = options?.tencentCloud?.endpoint ?? options?.endpoint ?? this.endpoint;
@@ -210,7 +215,7 @@ class ClsLoggerCore {
         if (!topicId) {
             // eslint-disable-next-line no-console
             console.warn('ClsLogger.init 没有传 topicID/topic_id');
-            return;
+            return false;
         }
         const nextEnvType = options.envType ?? this.detectEnvType();
         // envType/endpoint/retryTimes 变化时：重置 client（以及可能的 sdk）
@@ -247,15 +252,21 @@ class ClsLoggerCore {
         this.batchMaxSize = options.batch?.maxSize ?? this.batchMaxSize;
         this.batchIntervalMs = options.batch?.intervalMs ?? this.batchIntervalMs;
         this.startupDelayMs = options.batch?.startupDelayMs ?? this.startupDelayMs;
+        this.useIdleCallback = options.batch?.useIdleCallback ?? this.useIdleCallback;
+        this.idleTimeout = options.batch?.idleTimeout ?? this.idleTimeout;
+        // startupMaxSize：启动窗口内的队列阈值，默认为 maxSize * 10（至少 200）
+        this.startupMaxSize = options.batch?.startupMaxSize ?? Math.max(this.batchMaxSize * 10, 200);
         this.failedCacheKey = options.failedCacheKey ?? this.failedCacheKey;
         this.failedCacheMax = options.failedCacheMax ?? this.failedCacheMax;
         // 预热（避免首条日志触发 import/初始化开销）
-        void this.getInstance().catch(() => {
-            // ignore
-        });
+        const sdkReadyPromise = this.getInstance()
+            .then(() => true)
+            .catch(() => false);
         if (this.enabled) {
             // 启动时尝试发送失败缓存
             this.flushFailed();
+            // 添加页面可见性监听（确保页面关闭时数据不丢失）
+            this.setupVisibilityListener();
             // 初始化后立即启动请求监听
             this.startRequestMonitor(options.requestMonitor);
             // 初始化后立即启动错误监控/性能监控
@@ -264,6 +275,7 @@ class ClsLoggerCore {
             // 初始化后立即启动行为埋点（PV/UV/点击）
             this.startBehaviorMonitor(options.behaviorMonitor);
         }
+        return sdkReadyPromise;
     }
     getBaseFields() {
         let auto = undefined;
@@ -292,6 +304,97 @@ class ClsLoggerCore {
             return auto;
         return undefined;
     }
+    /**
+     * 设置页面可见性监听
+     * - visibilitychange: 页面隐藏时使用 sendBeacon 发送队列
+     * - pagehide: 作为移动端 fallback
+     * - 子类可覆写此方法以实现平台特定的监听（如小程序的 wx.onAppHide）
+     */
+    setupVisibilityListener() {
+        if (typeof document === 'undefined' || typeof window === 'undefined')
+            return;
+        // 避免重复监听
+        if (this.visibilityCleanup)
+            return;
+        const handleVisibilityChange = () => {
+            if (document.visibilityState === 'hidden') {
+                // 使用微任务延迟 flush，确保 web-vitals 等第三方库的 visibilitychange 回调先执行
+                // 这样 LCP/CLS/INP 等指标能先入队，再被 flush 发送
+                // 注意：queueMicrotask 比 setTimeout(0) 更可靠，不会被延迟太久
+                queueMicrotask(() => {
+                    this.flushBatchSync();
+                });
+            }
+        };
+        const handlePageHide = () => {
+            // pagehide 不能延迟，因为浏览器可能立即关闭页面
+            // 但 pagehide 通常在 visibilitychange 之后触发，此时队列应该已经包含 web-vitals 指标
+            this.flushBatchSync();
+        };
+        document.addEventListener('visibilitychange', handleVisibilityChange);
+        window.addEventListener('pagehide', handlePageHide);
+        this.visibilityCleanup = () => {
+            document.removeEventListener('visibilitychange', handleVisibilityChange);
+            window.removeEventListener('pagehide', handlePageHide);
+        };
+    }
+    /**
+     * 同步发送内存队列（使用 sendBeacon）
+     * - 用于页面关闭时确保数据发送
+     * - sendBeacon 不可用时降级为缓存到 localStorage
+     */
+    flushBatchSync() {
+        if (this.memoryQueue.length === 0)
+            return;
+        // 清除定时器
+        if (this.batchTimer) {
+            try {
+                if (this.useIdleCallback && typeof cancelIdleCallback !== 'undefined') {
+                    cancelIdleCallback(this.batchTimer);
+                }
+                else {
+                    clearTimeout(this.batchTimer);
+                }
+            }
+            catch {
+                // ignore
+            }
+            this.batchTimer = null;
+        }
+        this.batchTimerDueAt = null;
+        const logs = [...this.memoryQueue];
+        this.memoryQueue = [];
+        // 优先使用 sendBeacon（页面关闭时可靠发送）
+        if (typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+            try {
+                const payload = this.buildSendBeaconPayload(logs);
+                const blob = new Blob([payload], { type: 'application/json' });
+                const url = `${this.endpoint}/structuredlog?topic_id=${this.topicId}`;
+                const success = navigator.sendBeacon(url, blob);
+                if (!success) {
+                    // sendBeacon 返回 false 时，降级缓存
+                    this.cacheFailedReportLogs(logs);
+                }
+            }
+            catch {
+                this.cacheFailedReportLogs(logs);
+            }
+        }
+        else {
+            // 不支持 sendBeacon，降级缓存到 localStorage
+            this.cacheFailedReportLogs(logs);
+        }
+    }
+    /**
+     * 构建 sendBeacon 的 payload
+     */
+    buildSendBeaconPayload(logs) {
+        const logList = logs.map((log) => this.buildReportFields(log));
+        return JSON.stringify({
+            source: this.source,
+            logs: logList,
+        });
+    }
     startRequestMonitor(requestMonitor) {
         if (this.requestMonitorStarted)
             return;
@@ -537,32 +640,75 @@ class ClsLoggerCore {
             return;
         }
         this.memoryQueue.push(log);
-        if (this.memoryQueue.length >= this.batchMaxSize) {
+        const now = Date.now();
+        // 判断是否在启动合并窗口内
+        const inStartupWindow = this.startupDelayMs > 0 && now - this.initTs < this.startupDelayMs;
+        // 启动窗口内使用 startupMaxSize，正常情况使用 batchMaxSize
+        const effectiveMaxSize = inStartupWindow ? this.startupMaxSize : this.batchMaxSize;
+        if (this.memoryQueue.length >= effectiveMaxSize) {
             void this.flushBatch();
             return;
         }
-        const now = Date.now();
         const desiredDueAt = this.getDesiredBatchFlushDueAt(now);
         const desiredDelay = Math.max(0, desiredDueAt - now);
         if (!this.batchTimer) {
             this.batchTimerDueAt = desiredDueAt;
+            this.scheduleFlush(desiredDelay);
+            return;
+        }
+        // 启动合并窗口内：如果当前 timer 会"更早"触发，则延后到窗口结束，尽量减少多次发送
+        if (this.batchTimerDueAt !== null && this.batchTimerDueAt < desiredDueAt) {
+            this.cancelScheduledFlush();
+            this.batchTimerDueAt = desiredDueAt;
+            this.scheduleFlush(desiredDelay);
+        }
+    }
+    /**
+     * 调度批量发送
+     * - 先使用 setTimeout 保证最小延迟（desiredDelay）
+     * - 若开启 useIdleCallback，在延迟结束后等待浏览器空闲再执行
+     */
+    scheduleFlush(desiredDelay) {
+        if (this.useIdleCallback && typeof requestIdleCallback !== 'undefined') {
+            // 先 setTimeout 保证最小延迟，再 requestIdleCallback 在空闲时执行
+            this.batchTimer = setTimeout(() => {
+                const idleId = requestIdleCallback(() => {
+                    this.pendingIdleCallback = null;
+                    void this.flushBatch();
+                }, { timeout: this.idleTimeout });
+                this.pendingIdleCallback = idleId;
+            }, desiredDelay);
+        }
+        else {
             this.batchTimer = setTimeout(() => {
                 void this.flushBatch();
             }, desiredDelay);
-            return;
         }
-        // 启动合并窗口内：如果当前 timer 会“更早”触发，则延后到窗口结束，尽量减少多次发送
-        if (this.batchTimerDueAt !== null && this.batchTimerDueAt < desiredDueAt) {
+    }
+    /**
+     * 取消已调度的批量发送
+     * - 同时清理 setTimeout 和可能的 requestIdleCallback
+     */
+    cancelScheduledFlush() {
+        // 清理 setTimeout
+        if (this.batchTimer) {
             try {
                 clearTimeout(this.batchTimer);
             }
             catch {
                 // ignore
             }
-            this.batchTimerDueAt = desiredDueAt;
-            this.batchTimer = setTimeout(() => {
-                void this.flushBatch();
-            }, desiredDelay);
+            this.batchTimer = null;
+        }
+        // 清理可能的 pendingIdleCallback
+        if (this.pendingIdleCallback !== null && typeof cancelIdleCallback !== 'undefined') {
+            try {
+                cancelIdleCallback(this.pendingIdleCallback);
+            }
+            catch {
+                // ignore
+            }
+            this.pendingIdleCallback = null;
         }
     }
     getDesiredBatchFlushDueAt(nowTs) {
@@ -575,7 +721,7 @@ class ClsLoggerCore {
         }
         return nowTs + this.batchIntervalMs;
     }
-    info(message, data = {}) {
+    info(message, data = {}, options) {
         let msg = '';
         let extra = {};
         if (message instanceof Error) {
@@ -591,9 +737,18 @@ class ClsLoggerCore {
             extra = data;
         }
         const payload = normalizeFlatFields({ message: msg, ...extra }, 'info');
-        this.report({ type: 'info', data: payload, timestamp: Date.now() });
+        const log = { type: 'info', data: payload, timestamp: Date.now() };
+        // info 默认走批量队列，支持 immediate 选项立即发送
+        if (options?.immediate) {
+            void this.sendReportLogs([log]).catch(() => {
+                this.cacheFailedReportLogs([log]);
+            });
+        }
+        else {
+            this.report(log);
+        }
     }
-    warn(message, data = {}) {
+    warn(message, data = {}, options) {
         let msg = '';
         let extra = {};
         if (message instanceof Error) {
@@ -609,9 +764,18 @@ class ClsLoggerCore {
             extra = data;
         }
         const payload = normalizeFlatFields({ message: msg, ...extra }, 'warn');
-        this.report({ type: 'warn', data: payload, timestamp: Date.now() });
+        const log = { type: 'warn', data: payload, timestamp: Date.now() };
+        // warn 默认走批量队列，支持 immediate 选项立即发送
+        if (options?.immediate) {
+            void this.sendReportLogs([log]).catch(() => {
+                this.cacheFailedReportLogs([log]);
+            });
+        }
+        else {
+            this.report(log);
+        }
     }
-    error(message, data = {}) {
+    error(message, data = {}, options) {
         let msg = '';
         let extra = {};
         if (message instanceof Error) {
@@ -627,7 +791,17 @@ class ClsLoggerCore {
             extra = data;
         }
         const payload = normalizeFlatFields({ message: msg, ...extra }, 'error');
-        this.report({ type: 'error', data: payload, timestamp: Date.now() });
+        const log = { type: 'error', data: payload, timestamp: Date.now() };
+        // error 默认即时上报，除非显式指定 immediate: false
+        const immediate = options?.immediate ?? true;
+        if (immediate) {
+            void this.sendReportLogs([log]).catch(() => {
+                this.cacheFailedReportLogs([log]);
+            });
+        }
+        else {
+            this.report(log);
+        }
     }
     track(trackType, data = {}) {
         if (!trackType)
@@ -642,10 +816,7 @@ class ClsLoggerCore {
      * 立即发送内存队列
      */
     async flushBatch() {
-        if (this.batchTimer) {
-            clearTimeout(this.batchTimer);
-            this.batchTimer = null;
-        }
+        this.cancelScheduledFlush();
         this.batchTimerDueAt = null;
         if (this.memoryQueue.length === 0)
             return;
@@ -751,7 +922,14 @@ class ClsLoggerCore {
         // 先清空，再尝试发送
         writeStringStorage(this.failedCacheKey, JSON.stringify([]));
         this.memoryQueue.unshift(...logs);
-        void this.flushBatch();
+        // 触发定时器而非直接 flush，以尊重 startupDelayMs 配置
+        if (!this.batchTimer) {
+            const now = Date.now();
+            const desiredDueAt = this.getDesiredBatchFlushDueAt(now);
+            const desiredDelay = Math.max(0, desiredDueAt - now);
+            this.batchTimerDueAt = desiredDueAt;
+            this.scheduleFlush(desiredDelay);
+        }
     }
     /**
      * 统计/计数类日志：按字段展开上报（若 data 为空默认 1）
@@ -987,6 +1165,13 @@ function installMiniRequestMonitor(report, opts = {}) {
 const DEFAULT_MAX_TEXT = 4000;
 const DEFAULT_DEDUPE_WINDOW_MS = 3000;
 const DEFAULT_DEDUPE_MAX_KEYS = 200;
+/** 默认忽略的无意义错误信息 */
+const DEFAULT_IGNORE_MESSAGES = [
+    'Script error.',
+    'Script error',
+    /^ResizeObserver loop/,
+    'Permission was denied',
+];
 function truncate(s, maxLen) {
     if (!s)
         return s;
@@ -999,12 +1184,33 @@ function sampleHit$1(sampleRate) {
         return false;
     return Math.random() < sampleRate;
 }
+/** 检查消息是否应该被忽略 */
+function shouldIgnoreMessage(message, ignorePatterns) {
+    if (!message || ignorePatterns.length === 0)
+        return false;
+    return ignorePatterns.some((pattern) => {
+        if (typeof pattern === 'string') {
+            return message === pattern || message.includes(pattern);
+        }
+        return pattern.test(message);
+    });
+}
 function getMpPagePath() {
     try {
         const pages = globalThis.getCurrentPages?.();
         if (Array.isArray(pages) && pages.length > 0) {
             const page = pages[pages.length - 1];
-            return page.route || page.__route__ || '';
+            const route = page.route || page.__route__;
+            if (typeof route === 'string') {
+                let path = route.startsWith('/') ? route : `/${route}`;
+                const options = page.options || {};
+                const keys = Object.keys(options);
+                if (keys.length > 0) {
+                    const qs = keys.map((k) => `${k}=${options[k]}`).join('&');
+                    path = `${path}?${qs}`;
+                }
+                return path;
+            }
         }
         return '';
     }
@@ -1093,6 +1299,9 @@ function installMiniProgramErrorMonitor(report, options) {
                     if (!sampleHit$1(options.sampleRate))
                         return;
                     const e = normalizeErrorLike(msg, options.maxTextLength);
+                    // 检查是否应该忽略此错误
+                    if (shouldIgnoreMessage(e.message, options.ignoreMessages))
+                        return;
                     const payload = {
                         pagePath: getMpPagePath(),
                         source: 'wx.onError',
@@ -1120,6 +1329,9 @@ function installMiniProgramErrorMonitor(report, options) {
                     if (!sampleHit$1(options.sampleRate))
                         return;
                     const e = normalizeErrorLike(res?.reason, options.maxTextLength);
+                    // 检查是否应该忽略此错误
+                    if (shouldIgnoreMessage(e.message, options.ignoreMessages))
+                        return;
                     const payload = {
                         pagePath: getMpPagePath(),
                         source: 'wx.onUnhandledRejection',
@@ -1151,15 +1363,18 @@ function installMiniProgramErrorMonitor(report, options) {
                     try {
                         if (sampleHit$1(options.sampleRate)) {
                             const e = normalizeErrorLike(args?.[0], options.maxTextLength);
-                            const payload = {
-                                pagePath: getMpPagePath(),
-                                source: 'App.onError',
-                                message: e.message,
-                                errorName: e.name,
-                                stack: e.stack,
-                            };
-                            if (shouldReport(buildErrorKey(options.reportType, payload)))
-                                report(options.reportType, payload);
+                            // 检查是否应该忽略此错误
+                            if (!shouldIgnoreMessage(e.message, options.ignoreMessages)) {
+                                const payload = {
+                                    pagePath: getMpPagePath(),
+                                    source: 'App.onError',
+                                    message: e.message,
+                                    errorName: e.name,
+                                    stack: e.stack,
+                                };
+                                if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                    report(options.reportType, payload);
+                            }
                         }
                     }
                     catch {
@@ -1175,15 +1390,18 @@ function installMiniProgramErrorMonitor(report, options) {
                         if (sampleHit$1(options.sampleRate)) {
                             const reason = args?.[0]?.reason ?? args?.[0];
                             const e = normalizeErrorLike(reason, options.maxTextLength);
-                            const payload = {
-                                pagePath: getMpPagePath(),
-                                source: 'App.onUnhandledRejection',
-                                message: e.message,
-                                errorName: e.name,
-                                stack: e.stack,
-                            };
-                            if (shouldReport(buildErrorKey(options.reportType, payload)))
-                                report(options.reportType, payload);
+                            // 检查是否应该忽略此错误
+                            if (!shouldIgnoreMessage(e.message, options.ignoreMessages)) {
+                                const payload = {
+                                    pagePath: getMpPagePath(),
+                                    source: 'App.onUnhandledRejection',
+                                    message: e.message,
+                                    errorName: e.name,
+                                    stack: e.stack,
+                                };
+                                if (shouldReport(buildErrorKey(options.reportType, payload)))
+                                    report(options.reportType, payload);
+                            }
                         }
                     }
                     catch {
@@ -1214,6 +1432,7 @@ function installMiniErrorMonitor(report, opts = {}) {
         maxTextLength: raw.maxTextLength ?? DEFAULT_MAX_TEXT,
         dedupeWindowMs: raw.dedupeWindowMs ?? DEFAULT_DEDUPE_WINDOW_MS,
         dedupeMaxKeys: raw.dedupeMaxKeys ?? DEFAULT_DEDUPE_MAX_KEYS,
+        ignoreMessages: raw.ignoreMessages ?? DEFAULT_IGNORE_MESSAGES,
     };
     installMiniProgramErrorMonitor(report, options);
 }
@@ -1356,7 +1575,16 @@ function getMiniProgramPagePath() {
         const pages = typeof g.getCurrentPages === 'function' ? g.getCurrentPages() : [];
         const last = Array.isArray(pages) ? pages[pages.length - 1] : undefined;
         const route = (last?.route || last?.__route__);
-        return typeof route === 'string' ? route : '';
+        if (typeof route !== 'string')
+            return '';
+        let path = route.startsWith('/') ? route : `/${route}`;
+        const options = last?.options || {};
+        const keys = Object.keys(options);
+        if (keys.length > 0) {
+            const qs = keys.map((k) => `${k}=${options[k]}`).join('&');
+            path = `${path}?${qs}`;
+        }
+        return path;
     }
     catch {
         return '';
@@ -1619,7 +1847,7 @@ function getMiniProgramDeviceInfo(options) {
         try {
             if (typeof wxAny.getNetworkTypeSync === 'function') {
                 const n = wxAny.getNetworkTypeSync();
-                out.networkType = n?.networkType ? String(n.networkType) : '';
+                out.networkType = n?.networkType ? String(n.networkType).toUpperCase() : '';
             }
             else if (typeof wxAny.getNetworkType === 'function') {
                 // 异步更新：先不阻塞初始化
@@ -1629,7 +1857,9 @@ function getMiniProgramDeviceInfo(options) {
                             const g = globalThis;
                             if (!g.__beLinkClsLoggerDeviceInfo__)
                                 g.__beLinkClsLoggerDeviceInfo__ = {};
-                            g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType) : '';
+                            g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType
+                                ? String(res.networkType).toUpperCase()
+                                : '';
                         }
                         catch {
                             // ignore
@@ -1648,7 +1878,7 @@ function getMiniProgramDeviceInfo(options) {
                         const g = globalThis;
                         if (!g.__beLinkClsLoggerDeviceInfo__)
                             g.__beLinkClsLoggerDeviceInfo__ = {};
-                        g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType) : '';
+                        g.__beLinkClsLoggerDeviceInfo__.networkType = res?.networkType ? String(res.networkType).toUpperCase() : '';
                     }
                     catch {
                         // ignore
@@ -1689,7 +1919,7 @@ function createMiniDeviceInfoBaseFields(opts) {
         try {
             const g = globalThis;
             const extra = g[globalKey];
-            if (extra && isPlainObject(extra))
+            if (extra && typeof extra === 'object')
                 return { ...base, ...extra };
         }
         catch {
@@ -1732,6 +1962,25 @@ class ClsLoggerMini extends ClsLoggerCore {
     createDeviceInfoBaseFields(options) {
         return createMiniDeviceInfoBaseFields(options);
     }
+    /**
+     * 小程序版本的可见性监听
+     * - 监听 wx.onAppHide 在应用隐藏时发送日志
+     * - 确保用户关闭小程序或切后台时，队列中的日志不会丢失
+     */
+    setupVisibilityListener() {
+        const wxAny = globalThis.wx;
+        if (!wxAny || typeof wxAny.onAppHide !== 'function')
+            return;
+        // 避免重复监听
+        const g = globalThis;
+        if (g.__beLinkClsLoggerAppHideInstalled__)
+            return;
+        g.__beLinkClsLoggerAppHideInstalled__ = true;
+        wxAny.onAppHide(() => {
+            // 应用隐藏时立即发送队列中的日志
+            void this.flushBatch();
+        });
+    }
     normalize(m) {
         const mod = (m?.default && m.default.AsyncClient ? m.default : m);
         if (mod?.AsyncClient) {