sobey-monitor-sdk 1.1.4 → 1.1.5

package/dist/index.esm.js

@@ -274,13 +274,22 @@ class Sender {
      * 策略：优先使用 sendBeacon（更可靠），不支持或失败时降级为 fetch
      */
     doSend(data) {
+        // 检查配置是否已初始化
+        if (!config.isInitialized()) {
+            // 配置未初始化，数据放回缓冲区等待下次发送
+            this.buffer.unshift(...data);
+            this.scheduleFlush();
+            return;
+        }
         const cfg = config.get();
         const dsn = cfg.dsn;
-        // dsn 未配置，跳过发送
+        // dsn 未配置，将数据放回缓冲区等待下次发送
         if (!dsn) {
             if (cfg.debug) {
-                console.warn('[Monitor] dsn not configured, skip sending');
+                console.warn('[Monitor] dsn not configured, buffering data for later');
             }
+            this.buffer.unshift(...data);
+            this.scheduleFlush();
             return;
         }
         const payload = JSON.stringify(data);
@@ -401,25 +410,83 @@ class Reporter {
         }
     }
     /**
-     * 发送早期缓存的数据
+     * 发送早期缓存的数据（根据最新配置过滤）
      */
     flushEarlyBuffer() {
+        const cfg = config.get();
+        let skippedCount = 0;
+        // 全局开关检查：如果 enabled 为 false，清空缓存不上报
+        if (cfg.enabled === false) {
+            const totalCount = this.earlyBuffer.length;
+            this.earlyBuffer = [];
+            if (cfg.debug) {
+                console.log(`[Monitor] SDK disabled, discarded ${totalCount} early buffered items`);
+            }
+            return;
+        }
         while (this.earlyBuffer.length > 0) {
             const item = this.earlyBuffer.shift();
             if (!item)
                 continue;
+            // 根据最新配置过滤数据
             switch (item.type) {
                 case 'error':
+                    // 检查错误监控是否启用
+                    if (cfg.error?.enabled === false) {
+                        skippedCount++;
+                        continue;
+                    }
+                    // 根据错误类型检查具体开关
+                    const errorType = item.data?.type;
+                    if (errorType === 'js_error' && cfg.error?.jsError === false) {
+                        skippedCount++;
+                        continue;
+                    }
+                    if (errorType === 'promise_error' && cfg.error?.promiseError === false) {
+                        skippedCount++;
+                        continue;
+                    }
+                    if (errorType === 'resource_error' && cfg.error?.resourceError === false) {
+                        skippedCount++;
+                        continue;
+                    }
+                    if (errorType === 'http_error' && cfg.error?.httpError === false) {
+                        skippedCount++;
+                        continue;
+                    }
                     this.reportError(item.data);
                     break;
                 case 'performance':
+                    // 检查性能监控是否启用
+                    if (cfg.performance?.enabled === false) {
+                        skippedCount++;
+                        continue;
+                    }
                     this.reportPerformance(item.data);
                     break;
                 case 'behavior':
+                    // 检查行为监控是否启用
+                    if (cfg.behavior?.enabled === false) {
+                        skippedCount++;
+                        continue;
+                    }
+                    // 根据行为类型检查具体开关
+                    const action = item.data?.action;
+                    if (action === 'pv' && cfg.behavior?.pv === false) {
+                        skippedCount++;
+                        continue;
+                    }
+                    if (action === 'route' && cfg.behavior?.route === false) {
+                        skippedCount++;
+                        continue;
+                    }
                     this.reportBehavior(item.data);
                     break;
             }
         }
+        if (skippedCount > 0 && cfg.debug) {
+            console.log(`[Monitor] Filtered out ${skippedCount} early buffered items based on config`);
+        }
     }
     /**
      * 缓存早期数据
@@ -548,17 +615,15 @@ const reporter = new Reporter();
  */
 function installJsErrorHandler() {
     window.addEventListener('error', (event) => {
-        // 延迟检查配置（SDK 可能还在加载配置）
-        if (config.isInitialized()) {
-            const cfg = config.get();
-            if (!cfg.error?.enabled || !cfg.error?.jsError) {
-                return;
-            }
-        }
         // 过滤资源加载错误（由 resourceError 处理）
         if (event.target !== window) {
             return;
         }
+        // 检查配置（在事件触发时检查，而不是安装时）
+        const cfg = config.isInitialized() ? config.get() : null;
+        if (cfg?.error?.enabled === false || cfg?.error?.jsError === false) {
+            return;
+        }
         const errorData = {
             type: 'js_error',
             message: event.message || 'Unknown error',
@@ -579,6 +644,7 @@ function installJsErrorHandler() {
         });
         reporter.reportError(errorData);
     }, true);
+    console.log('[Monitor] JS error handler installed');
 }
 
 /**
@@ -589,12 +655,10 @@ function installJsErrorHandler() {
  */
 function installPromiseErrorHandler() {
     window.addEventListener('unhandledrejection', (event) => {
-        // 延迟检查配置（SDK 可能还在加载配置）
-        if (config.isInitialized()) {
-            const cfg = config.get();
-            if (!cfg.error?.enabled || !cfg.error?.promiseError) {
-                return;
-            }
+        // 检查配置（在事件触发时检查，而不是安装时）
+        const cfg = config.isInitialized() ? config.get() : null;
+        if (cfg?.error?.enabled === false || cfg?.error?.promiseError === false) {
+            return;
         }
         let message = 'Unhandled Promise rejection';
         let stack;
@@ -624,6 +688,7 @@ function installPromiseErrorHandler() {
         });
         reporter.reportError(errorData);
     });
+    console.log('[Monitor] Promise error handler installed');
 }
 
 /**
@@ -634,18 +699,16 @@ function installPromiseErrorHandler() {
  */
 function installResourceErrorHandler() {
     window.addEventListener('error', (event) => {
-        // 延迟检查配置（SDK 可能还在加载配置）
-        if (config.isInitialized()) {
-            const cfg = config.get();
-            if (!cfg.error?.enabled || !cfg.error?.resourceError) {
-                return;
-            }
-        }
         const target = event.target;
         // 只处理资源加载错误（target 不是 window）
         if (!target || target === window || !(target instanceof HTMLElement)) {
             return;
         }
+        // 检查配置（在事件触发时检查，而不是安装时）
+        const cfg = config.isInitialized() ? config.get() : null;
+        if (cfg?.error?.enabled === false || cfg?.error?.resourceError === false) {
+            return;
+        }
         const tagName = target.tagName.toLowerCase();
         // 只监控特定标签的资源
         if (!['img', 'script', 'link', 'video', 'audio', 'source'].includes(tagName)) {
@@ -674,6 +737,7 @@ function installResourceErrorHandler() {
         });
         reporter.reportError(errorData);
     }, true); // 使用捕获阶段
+    console.log('[Monitor] Resource error handler installed');
 }
 
 /**
@@ -690,6 +754,7 @@ const originalFetch = window.fetch;
 function installHttpErrorHandler() {
     interceptXHR();
     interceptFetch();
+    console.log('[Monitor] HTTP error handler installed');
 }
 /**
  * 检查是否是 SDK 自身的请求
@@ -702,18 +767,6 @@ function isSdkRequest(url) {
         return false;
     return url.includes(cfg.dsn);
 }
-/**
- * 检查 HTTP 错误监控是否启用
- */
-function isHttpErrorEnabled() {
-    if (!config.isInitialized())
-        return true; // 配置未就绪时默认启用，数据会被缓存
-    const cfg = config.get();
-    return cfg.error?.enabled !== false && cfg.error?.httpError !== false;
-}
-/**
- * 拦截 XMLHttpRequest
- */
 function interceptXHR() {
     XMLHttpRequest.prototype.open = function (method, url, async = true, username, password) {
         const urlStr = url.toString();
@@ -743,16 +796,11 @@ function interceptXHR() {
         this.addEventListener('loadend', function () {
             if (!monitorData)
                 return;
-            if (!isHttpErrorEnabled())
-                return;
             const duration = Date.now() - monitorData.startTime;
             const status = this.status;
             // 根据配置决定是否添加到面包屑
-            let recordMode = 'error';
-            if (config.isInitialized()) {
-                const cfg = config.get();
-                recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
-            }
+            const cfg = config.get();
+            const recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
             // 重定向(3xx)始终记录，不受配置控制
             const isRedirect = status >= 300 && status < 400;
             // 其他异常情况（0-网络错误、4xx-客户端错误、5xx-服务端错误）根据配置控制
@@ -799,17 +847,11 @@ function interceptFetch() {
         const requestBody = typeof init?.body === 'string' ? init.body : undefined;
         try {
             const response = await originalFetch.call(window, input, init);
-            if (!isHttpErrorEnabled()) {
-                return response;
-            }
             const duration = Date.now() - startTime;
             const status = response.status;
             // 根据配置决定是否添加到面包屑
-            let recordMode = 'error';
-            if (config.isInitialized()) {
-                const cfg = config.get();
-                recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
-            }
+            const cfg = config.get();
+            const recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
             // 重定向(3xx)始终记录，不受配置控制
             const isRedirect = status >= 300 && status < 400;
             // 其他异常情况根据配置控制
@@ -848,16 +890,10 @@ function interceptFetch() {
             return response;
         }
         catch (error) {
-            if (!isHttpErrorEnabled()) {
-                throw error;
-            }
             const duration = Date.now() - startTime;
             // 网络错误时根据配置决定是否添加到面包屑
-            let recordMode = 'error';
-            if (config.isInitialized()) {
-                const cfg = config.get();
-                recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
-            }
+            const cfg = config.get();
+            const recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
             // 网络错误属于 error，当模式为 'all' 或 'error' 时都记录
             if (recordMode !== 'none') {
                 context.addBreadcrumb({
@@ -895,10 +931,6 @@ function reportHttpError(httpInfo) {
     reporter.reportError(errorData);
 }
 
-/**
- * 白屏检测插件
- * 使用 DOM 采样检测页面是否白屏
- */
 // 采样点 - 页面关键区域
 const SAMPLE_POINTS = [
     { x: 0.5, y: 0.1 }, // 顶部中间
@@ -922,6 +954,7 @@ function installWhiteScreenDetector() {
             scheduleDetection();
         });
     }
+    console.log('[Monitor] White screen detector installed');
 }
 /**
  * 调度检测（延迟执行，给页面渲染时间）
@@ -929,13 +962,6 @@ function installWhiteScreenDetector() {
 function scheduleDetection() {
     // 延迟 1 秒检测
     setTimeout(() => {
-        // 检测时才检查配置
-        if (config.isInitialized()) {
-            const cfg = config.get();
-            if (!cfg.error?.enabled) {
-                return;
-            }
-        }
         const isWhiteScreen = detectWhiteScreen();
         if (isWhiteScreen) {
             reportWhiteScreen();
@@ -1000,10 +1026,6 @@ function installErrorHandlers() {
  * 安装 Web Vitals 采集
  */
 function installWebVitals() {
-    const cfg = config.get();
-    if (!cfg.performance?.enabled || !cfg.performance?.webVitals) {
-        return;
-    }
     // 页面加载完成后采集
     if (document.readyState === 'complete') {
         collectMetrics();
@@ -1014,14 +1036,17 @@ function installWebVitals() {
             setTimeout(collectMetrics, 3000);
         });
     }
-    if (cfg.debug) {
-        console.log('[Monitor] Web Vitals collector installed');
-    }
+    console.log('[Monitor] Web Vitals collector installed');
 }
 /**
  * 采集性能指标
  */
 function collectMetrics() {
+    // 检查配置（在采集时检查，而不是安装时）
+    const cfg = config.isInitialized() ? config.get() : null;
+    if (cfg?.performance?.enabled === false || cfg?.performance?.webVitals === false) {
+        return;
+    }
     const metrics = {};
     // 使用 Performance API
     if (!window.performance) {
@@ -1130,22 +1155,13 @@ function installPerformanceMonitor() {
     installWebVitals();
 }
 
-/**
- * PV (Page View) 统计插件
- */
 /**
  * 安装 PV 统计
  */
 function installPVTracker() {
-    const cfg = config.get();
-    if (!cfg.behavior?.enabled || !cfg.behavior?.pv) {
-        return;
-    }
-    // 页面加载时上报
+    // 页面加载时上报（reporter 会缓存直到 SDK 就绪）
     reportPV();
-    if (cfg.debug) {
-        console.log('[Monitor] PV tracker installed');
-    }
+    console.log('[Monitor] PV tracker installed');
 }
 /**
  * 上报 PV
@@ -1168,11 +1184,12 @@ function reportPV() {
  * 安装点击追踪
  */
 function installClickTracker() {
-    const cfg = config.get();
-    if (!cfg.behavior?.enabled || !cfg.behavior?.click) {
-        return;
-    }
     document.addEventListener('click', (event) => {
+        // 检查配置（在事件触发时检查，而不是安装时）
+        const cfg = config.isInitialized() ? config.get() : null;
+        if (cfg?.behavior?.enabled === false || cfg?.behavior?.click === false) {
+            return;
+        }
         const target = event.target;
         if (!target)
             return;
@@ -1190,9 +1207,7 @@ function installClickTracker() {
         //   data: clickData,
         // });
     }, true);
-    if (cfg.debug) {
-        console.log('[Monitor] Click tracker installed');
-    }
+    console.log('[Monitor] Click tracker installed');
 }
 /**
  * 提取点击数据
@@ -1271,10 +1286,6 @@ const originalReplaceState = history.replaceState;
  * 安装路由监控
  */
 function installRouteTracker() {
-    const cfg = config.get();
-    if (!cfg.behavior?.enabled || !cfg.behavior?.route) {
-        return;
-    }
     // 拦截 pushState
     history.pushState = function (...args) {
         const result = originalPushState.apply(this, args);
@@ -1295,14 +1306,17 @@ function installRouteTracker() {
     window.addEventListener('hashchange', () => {
         handleRouteChange('hashchange');
     });
-    if (cfg.debug) {
-        console.log('[Monitor] Route tracker installed');
-    }
+    console.log('[Monitor] Route tracker installed');
 }
 /**
  * 处理路由变化
  */
 function handleRouteChange(trigger) {
+    // 检查配置（在事件触发时检查，而不是安装时）
+    const cfg = config.isInitialized() ? config.get() : null;
+    if (cfg?.behavior?.enabled === false || cfg?.behavior?.route === false) {
+        return;
+    }
     const routeData = {
         url: getPageUrl(),
         title: getPageTitle(),
@@ -1337,16 +1351,16 @@ const originalConsole = {
  * 安装控制台追踪
  */
 function installConsoleTracker() {
-    const cfg = config.get();
-    // 默认启用控制台追踪（跟随 behavior.enabled）
-    if (!cfg.behavior?.enabled) {
-        return;
-    }
     const levels = ['log', 'info', 'warn', 'error'];
     levels.forEach((level) => {
         console[level] = function (...args) {
             // 调用原始方法
             originalConsole[level].apply(console, args);
+            // 检查配置（在调用时检查，而不是安装时）
+            const cfg = config.isInitialized() ? config.get() : null;
+            if (cfg?.behavior?.enabled === false) {
+                return;
+            }
             // 添加到面包屑（只记录 warn 和 error）
             if (level === 'warn' || level === 'error') {
                 const message = formatConsoleArgs(args);
@@ -1361,9 +1375,7 @@ function installConsoleTracker() {
             }
         };
     });
-    if (cfg.debug) {
-        originalConsole.log('[Monitor] Console tracker installed');
-    }
+    originalConsole.log('[Monitor] Console tracker installed');
 }
 /**
  * 格式化控制台参数
@@ -1395,24 +1407,22 @@ function formatConsoleArgs(args) {
  * 安装输入追踪
  */
 function installInputTracker() {
-    const cfg = config.get();
-    // 默认启用输入追踪（跟随 behavior.enabled）
-    if (!cfg.behavior?.enabled) {
-        return;
-    }
     // 监听 input 事件（使用 change 事件减少数据量）
     document.addEventListener('change', handleInputChange, true);
     // 监听焦点事件
     document.addEventListener('focus', handleFocus, true);
     document.addEventListener('blur', handleBlur, true);
-    if (cfg.debug) {
-        console.log('[Monitor] Input tracker installed');
-    }
+    console.log('[Monitor] Input tracker installed');
 }
 /**
  * 处理输入变化
  */
 function handleInputChange(event) {
+    // 检查配置（在事件触发时检查，而不是安装时）
+    const cfg = config.isInitialized() ? config.get() : null;
+    if (cfg?.behavior?.enabled === false) {
+        return;
+    }
     const target = event.target;
     if (!target || !isFormElement(target))
         return;
@@ -1427,6 +1437,11 @@ function handleInputChange(event) {
  * 处理焦点获取
  */
 function handleFocus(event) {
+    // 检查配置
+    const cfg = config.isInitialized() ? config.get() : null;
+    if (cfg?.behavior?.enabled === false) {
+        return;
+    }
     const target = event.target;
     if (!target || !isFormElement(target))
         return;
@@ -1440,6 +1455,11 @@ function handleFocus(event) {
  * 处理焦点失去
  */
 function handleBlur(event) {
+    // 检查配置
+    const cfg = config.isInitialized() ? config.get() : null;
+    if (cfg?.behavior?.enabled === false) {
+        return;
+    }
     const target = event.target;
     if (!target || !isFormElement(target))
         return;