sobey-monitor-sdk 1.0.5 → 1.0.7

package/README.md

@@ -119,6 +119,8 @@ ReactDOM.render(
 | `sampling.error` | number | 1 | 错误采样率 (0-1) |
 | `sampling.performance` | number | 1 | 性能采样率 (0-1) |
 | `sampling.behavior` | number | 1 | 行为采样率 (0-1) |
+| `behavior.maxBreadcrumbs` | number | 20 | 行为回溯最大记录数 |
+| `behavior.recordRequestBreadcrumb` | 'all' \| 'error' \| 'none' | 'error' | 网络请求记录模式：'all' 记录所有、'error' 记录非 2xx 响应（重定向、4xx、5xx、网络错误）、'none' 不记录 |
 | `report.maxBufferSize` | number | 10 | 缓冲区最大数量 |
 | `report.flushInterval` | number | 5000 | 上报间隔 (ms) |
 

package/dist/index.cjs.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
  * 默认配置
  */
 const DEFAULT_CONFIG = {
+    enabled: true,
     debug: false,
     sampling: {
         error: 1,
@@ -36,6 +37,7 @@ const DEFAULT_CONFIG = {
         click: true,
         route: true,
         maxBreadcrumbs: 20,
+        recordRequestBreadcrumb: 'error',
     },
 };
 /**
@@ -447,6 +449,13 @@ class Reporter {
      */
     send(data) {
         const cfg = config.get();
+        // 全局开关检查：如果 enabled 为 false，则不上报
+        if (cfg.enabled === false) {
+            if (cfg.debug) {
+                console.log('[Monitor] SDK disabled, skip report:', data.type || 'unknown');
+            }
+            return;
+        }
         if (cfg.debug) {
             console.log('[Monitor] Report:', data);
         }
@@ -662,18 +671,26 @@ function interceptXHR() {
                 return;
             const duration = Date.now() - monitorData.startTime;
             const status = this.status;
-            // 添加到面包屑
-            context.addBreadcrumb({
-                type: 'request',
-                category: 'xhr',
-                data: {
-                    method: monitorData.method,
-                    url: monitorData.url,
-                    status,
-                    duration,
-                },
-            });
-            // 只上报错误请求 (4xx, 5xx 或 0)
+            // 根据配置决定是否添加到面包屑
+            const cfg = config.get();
+            const recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
+            // 重定向(3xx)始终记录，不受配置控制
+            const isRedirect = status >= 300 && status < 400;
+            // 其他异常情况（0-网络错误、4xx-客户端错误、5xx-服务端错误）根据配置控制
+            const isError = status === 0 || status < 200 || status >= 400;
+            const shouldRecord = isRedirect || recordMode === 'all' || (recordMode === 'error' && isError);
+            if (shouldRecord) {
+                context.addBreadcrumb({
+                    type: 'request',
+                    category: 'xhr',
+                    data: {
+                        method: monitorData.method,
+                        url: monitorData.url,
+                        status,
+                        duration,
+                    },
+                });
+            }
             if (status === 0 || status >= 400) {
                 reportHttpError({
                     method: monitorData.method,
@@ -705,18 +722,26 @@ function interceptFetch() {
             const response = await originalFetch.call(window, input, init);
             const duration = Date.now() - startTime;
             const status = response.status;
-            // 添加到面包屑
-            context.addBreadcrumb({
-                type: 'request',
-                category: 'fetch',
-                data: {
-                    method,
-                    url,
-                    status,
-                    duration,
-                },
-            });
-            // 只上报错误请求
+            // 根据配置决定是否添加到面包屑
+            const cfg = config.get();
+            const recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
+            // 重定向(3xx)始终记录，不受配置控制
+            const isRedirect = status >= 300 && status < 400;
+            // 其他异常情况根据配置控制
+            const isError = status < 200 || status >= 400;
+            const shouldRecord = isRedirect || recordMode === 'all' || (recordMode === 'error' && isError);
+            if (shouldRecord) {
+                context.addBreadcrumb({
+                    type: 'request',
+                    category: 'fetch',
+                    data: {
+                        method,
+                        url,
+                        status,
+                        duration,
+                    },
+                });
+            }
             if (!response.ok) {
                 // 克隆响应以读取 body
                 const cloned = response.clone();
@@ -739,18 +764,23 @@ function interceptFetch() {
         }
         catch (error) {
             const duration = Date.now() - startTime;
-            // 网络错误
-            context.addBreadcrumb({
-                type: 'request',
-                category: 'fetch',
-                data: {
-                    method,
-                    url,
-                    status: 0,
-                    duration,
-                    error: error.message,
-                },
-            });
+            // 网络错误时根据配置决定是否添加到面包屑
+            const cfg = config.get();
+            const recordMode = cfg.behavior?.recordRequestBreadcrumb || 'error';
+            // 网络错误属于 error，当模式为 'all' 或 'error' 时都记录
+            if (recordMode !== 'none') {
+                context.addBreadcrumb({
+                    type: 'request',
+                    category: 'fetch',
+                    data: {
+                        method,
+                        url,
+                        status: 0,
+                        duration,
+                        error: error.message,
+                    },
+                });
+            }
             reportHttpError({
                 method,
                 url,
@@ -1079,10 +1109,14 @@ function installClickTracker() {
 function extractClickData(element, event) {
     const tagName = element.tagName.toLowerCase();
     const rect = element.getBoundingClientRect();
+    // SVG 元素的 className 是 SVGAnimatedString 对象，需要特殊处理
+    const classNameStr = typeof element.className === 'string'
+        ? element.className
+        : element.className?.baseVal || '';
     return {
         tagName,
         id: element.id || undefined,
-        className: element.className || undefined,
+        className: classNameStr || undefined,
         text: getElementText(element),
         path: getElementPath(element),
         // 鼠标坐标
@@ -1120,7 +1154,11 @@ function getElementPath(element) {
             selector += `#${current.id}`;
         }
         else if (current.className) {
-            const classes = current.className.split(' ').filter(Boolean).slice(0, 2);
+            // SVG 元素的 className 是 SVGAnimatedString 对象，需要特殊处理
+            const classNameStr = typeof current.className === 'string'
+                ? current.className
+                : current.className?.baseVal || '';
+            const classes = classNameStr.split(' ').filter(Boolean).slice(0, 2);
             if (classes.length) {
                 selector += `.${classes.join('.')}`;
             }