frontend-monitor-core

v2.3.0

Published

2 months ago

Core browser monitoring SDK with modular integrations for frontend-monitor.

0High
0Medium
0Low

jacob.sun

monitoring frontend sdk tree-shaking tracing web-vitals

frontend-monitor-core

浏览器端监控 SDK 核心包，负责初始化、自动采集、手动埋点、队列上报、脱敏 hook、本地化缓存和页面退出发送。

Install

pnpm add frontend-monitor-core

Quick Start

import { init, track, captureError } from "frontend-monitor-core"

init({
  dsn: "/api/v1/monitor/collect/demo-project-key",
  appName: "my-app"
})

track("button_click", { area: "hero" })
captureError(new Error("manual error"))

Tree-shaking Friendly Usage

根入口 frontend-monitor-core 会继续自动注册内置 integrations，兼容当前默认行为。如果你希望让 bundler 只打进实际用到的采集模块，改用 lite 入口加按需 integration 子路径：

import { init, track } from "frontend-monitor-core/lite"
import { JSErrorIntegration } from "frontend-monitor-core/integrations/js-error"
import { PerformanceIntegration } from "frontend-monitor-core/integrations/performance"

init({
  dsn: "/api/v1/monitor/collect/demo-project-key",
  appName: "my-app",
  integrations: [new JSErrorIntegration(), new PerformanceIntegration()]
})

track("checkout_submit")

frontend-monitor-core/lite 不会自动挂任何内置 integration；只有你显式传入或运行时 addIntegration() 的模块才会生效。

Source Layout

当前 src/ 目录按职责拆分，方便继续维护和扩展：

api/: 对外 API、内置 integration 装配、integration 注册
core/: 配置、types、状态、hooks、生命周期
pipeline/: payload 构建、队列、发送、压缩、replay
storage/: localization、offline retry、异步队列存储
capture/: 具体采集实现
integrations/: 可插拔 integration 类
__tests__/: 单元测试和浏览器 fake
utils/: 通用工具函数

Main APIs

init(options)
destroy()
track(eventName, params?, flush?)
captureError(error, params?, flush?)
setUser(userId)
beforeSend(handler)
beforePushEvent(handler)
afterSend(handler)
addIntegration(integration)
flush()
flushSessionReplay()
getDiagnostics()
getTraceContext()
getReplayId()
startTransaction(name, options?)
startSpan(name, options?)
withSpan(span, callback)
stopReplay()
sendLocal()
getOptions()
intersectionObserver()
intersectionUnobserve()
intersectionDisconnect()

Integrations

默认情况下，SDK 会自动注册内置 integrations 来维持当前行为，包括：

ConsoleErrorIntegration
JSErrorIntegration
FetchIntegration
XHRIntegration
NavigationIntegration
PageExitIntegration
NetworkStatusIntegration
SessionReplayIntegration
PerformanceIntegration
ClickIntegration

如果你要扩展新的采集类型，可以在初始化时传入 integrations，或在初始化后调用 addIntegration()：

import {
  addIntegration,
  init,
  type MonitorIntegration
} from "frontend-monitor-core"

const customIntegration: MonitorIntegration = {
  name: "custom-visibility",
  setup(context) {
    const onVisible = () => {
      context.emit(
        {
          eventName: "custom_visible",
          timestamp: Date.now(),
          type: "custom",
          url: window.location.href
        },
        true
      )
    }

    window.addEventListener("custom-visible", onVisible)
    return () => window.removeEventListener("custom-visible", onVisible)
  }
}

init({
  dsn: "/api/v1/monitor/collect/demo-project-key",
  appName: "demo",
  integrations: [customIntegration]
})

addIntegration({
  name: "runtime-feature",
  setup(context) {
    context.emit(
      {
        eventName: "runtime_loaded",
        timestamp: Date.now(),
        type: "custom",
        url: window.location.href
      },
      true
    )
  }
})

setup(context) 当前提供：

context.emit(event, flush?)：把自定义事件送入现有队列、采样、hook 和发送链路。
context.addCleanup(fn)：注册销毁清理逻辑，destroy() 时自动执行。
context.options：只读的当前解析后配置。

MonitorOptions

init() 的参数类型来自 MonitorOptions。下面按字段整理实际含义、默认值和使用建议。

必填字段

| 字段 | 类型 | 必填 | 说明 | | --- | --- | --- | --- | | dsn | string | 是 | 数据上报地址。SDK 会把它自动加入 ignoreUrls，避免监控请求递归采集。 | | appName | string | 是 | 应用名称，会进入每次上报的 base.appName。 |

基础信息

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | appVersion | string | 无 | 应用版本号，适合做版本维度筛选。 | | userId | string | 无 | 当前用户标识，会写入 base.userId。也可以在初始化后通过 setUser() 动态设置。 | | debugId | string | 无 | 构建产物调试标识，会进入 base.debugId 和错误事件，供 Source Map 关联使用。 | | debug | boolean | false | 开启后会在控制台打印采样丢弃、发送成功/失败、离线丢弃等调试日志。 | | ignoreErrors | Array<string \| RegExp> | [] | 命中后丢弃对应 JS 错误或 Promise rejection。 | | allowUrls | Array<string \| RegExp> | [] | 配置后只有错误来源 URL 命中时才上报错误。 | | denyUrls | Array<string \| RegExp> | [] | 命中错误来源 URL 时丢弃错误，优先级高于 allow。 |

队列与发送

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | sampleRate | number | 1 | 采样率，范围会被钳制到 0 ~ 1。只影响普通入队事件，不影响显式 flush = true 的事件。 | | batchSize | number | 5 | 队列达到该数量后立即触发发送。最小为 1。 | | flushInterval | number | 5000 | 定时批量发送间隔，单位毫秒。最小为 0。 | | maxQueueLength | number | 200 | 内存队列最大长度。超出后会丢弃最早的事件，保留最新事件。 | | timeout | number | 5000 | 网络发送超时时间，单位毫秒。主要用于 xhr/fetch 发送链路。 | | ignoreUrls | Array<string \\| RegExp> | [] + dsn | 需要忽略的请求地址。匹配到的 fetch/xhr 请求不会进入监控事件。SDK 会自动追加当前 dsn。 | | offlineRetry | boolean | true | 离线或发送失败时把 payload 写入本地离线队列，在线后自动重试。 | | offlineQueueKey | string | __frontend_monitor_offline__ | 自动离线重试队列的逻辑 key。SDK 会优先写入 IndexedDB，不可用时回退到 localStorage。 | | retryMaxAttempts | number | 3 | 自动重试最大次数。 | | retryBaseDelay | number | 1000 | 自动重试基础退避时间，单位毫秒。 | | maxPayloadBytes | number | 65536 | 单次 payload 最大字节数，按 UTF-8 字节计算；批量 payload 超出时会尝试拆批，单事件仍超限才丢弃。 | | maxOfflinePayloads | number | 50 | 自动离线重试队列最多保留的 payload 数。 | | maxBreadcrumbs | number | 50 | payload 中最多携带的 breadcrumb 数。 | | compression | boolean \| CompressionOptions | { algorithm: "gzip", eventPayloads: false, sessionReplay: true } | 显式控制发送前是否尝试压缩。布尔值会同时作用于普通 payload 和 replay chunk。 |

CompressionOptions 子字段：

| 字段 | 默认值 | 说明 | | --- | --- | --- | | algorithm | "gzip" | 当前仅支持 gzip。保留为显式字段，便于后续扩展 br 等算法而不改变配置结构。 | | eventPayloads | false | 是否对普通事件批量 payload 启用 gzip 压缩。默认关闭，避免对主上报链路引入额外兼容风险。 | | sessionReplay | true | 是否对 replay chunk 启用 gzip 压缩。默认开启，优先降低高频 rrweb 片段的体积。 |

采集开关

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | capture | CaptureOptions | 见下表 | 控制自动采集模块是否启用。未传时使用默认配置。 |

capture 的子字段如下：

| 字段 | 默认值 | 说明 | | --- | --- | --- | | jsError | true | 采集运行时脚本错误。 | | promiseRejection | true | 采集未处理的 Promise rejection。 | | consoleError | true | 采集 console.error(...)。 | | resourceError | true | 采集脚本、样式、图片等资源加载失败。 | | fetchError | true | 采集失败的 fetch 请求。 | | xhrError | true | 采集失败的 XMLHttpRequest 请求。 | | performance | true | 采集页面性能事件，包含 navigation、resource 和 Web Vitals。 | | requestPerformance | true | 采集成功请求的性能事件。 | | pageView | true | 初始化时自动发送一次 PV。 | | routeChange | true | 采集 hashchange / pushState / replaceState / popstate。 | | click | true | 采集点击事件。输入类元素内容会被脱敏。 | | exposure | true | 允许曝光采集能力；需要你主动调用 intersectionObserver() 注册目标元素。 |

本地化缓存

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | localization | boolean | false | 开启后，发送前的 payload 不会立刻上报，而是写入本地缓存队列。适合手动控制发送时机。 | | localizationKey | string | __frontend_monitor_local__ | 本地化缓存使用的逻辑 key。SDK 会优先写入 IndexedDB，不可用时回退到 localStorage。 | | localizationOverflow | (error: Error) => void | 无 | 当本地缓存写入失败时触发，常见原因是容量超限、浏览器限制，或存储不可用。 |

本地化模式的运行语义：

localization = true 时，flush() 触发的是“写入本地”，不是“立即联网发送”。
真正发送本地缓存需要手动调用 sendLocal()。
sendLocal() 会逐条发送；失败的数据会保留，成功的数据会被移除。

诊断上下文

初始化时可传入 release、environment、tags、contexts，运行时也可通过：

setRelease(release)
setEnvironment(environment)
setTag(key, value)
setContext(key, value)
addBreadcrumb(breadcrumb)
clearContext()

SDK 会自动把路由、点击、失败请求和 console.error 写入 breadcrumbs，随下一次 payload 上报。

错误诊断字段

错误事件会保留原始 message/stack/source，同时尽量补充结构化诊断字段：

exception: 错误类型、错误消息和结构化 stacktrace。
frames: 从 Chrome/Edge、Firefox、Safari 常见 stack 格式解析出的文件、函数、行列号。
mechanism: 错误来源，手动 captureError() 为 manual 且 handled=true，全局错误和未处理 Promise 为未处理错误。
causeChain: Error.cause 和 AggregateError.errors 的简化链路。
release/dist/debugId: 与当前初始化配置一致，供后端 Source Map 关联。

请求体采集

失败请求默认不会携带请求体。需要排查特定接口时，显式开启 requestBody 并使用 URL 与 content-type 规则收窄采集范围：

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | requestBody.enabled | boolean | false | 是否允许采集失败请求的请求体。 | | requestBody.allowUrls | Array<string \| RegExp> | [] | 允许采集请求体的 URL 规则；为空时不按 URL 放宽限制。 | | requestBody.denyUrls | Array<string \| RegExp> | [] | 禁止采集请求体的 URL 规则，优先级高于 allow。 | | requestBody.contentTypes | string[] | 常见 JSON、表单、文本类型 | 只有请求 content-type 命中时才读取请求体。 | | requestBody.maxBytes | number | 2048 | 单个归一化请求体最大字节数，超出后不写入事件。 | | requestBody.captureHeaders | boolean | false | 预留字段，后续用于显式采集请求头。 |

脱敏配置

默认会对 token、手机号、身份证号、密码类字段和输入框内容做脱敏。可以通过 sanitize 追加业务规则：

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | sanitize.enabled | boolean | true | 是否启用发送前自动脱敏。默认情况下 beforeSend 收到的是已脱敏 payload；关闭后 beforeSend 会收到原始 payload。 | | sanitize.sensitiveKeys | string[] | [] | 追加需要整体替换的字段名，和内置敏感字段合并。 | | sanitize.textPatterns | RegExp[] | [] | 追加需要在字符串中替换的文本规则。 | | sanitize.redactValue | string | [REDACTED] | 字段整体替换和自定义文本规则的替换值。 |

自定义传输

默认发送链路仍按 image -> sendBeacon -> xhr 选择。需要接入自有网关、加密或签名时，可以传入 transport.send：

init({
  dsn: "/api/v1/monitor/collect/demo-project-key",
  appName: "demo",
  transport: {
    async send(dsn, payload, options) {
      const response = await fetch(dsn, {
        body: JSON.stringify(payload),
        headers: { "content-type": "application/json" },
        method: "POST",
        signal: AbortSignal.timeout(options.timeout ?? 5000)
      })

      return {
        status: response.status,
        success: response.ok,
        transport: "xhr"
      }
    }
  }
})

自定义传输失败时仍会进入自动离线重试队列；maxPayloadBytes 仍会先拦截超大 payload。

如果使用内置发送链路，SDK 会按 compression 配置决定是否在 xhr/fetch 发送前尝试 CompressionStream("gzip")。当浏览器不支持压缩，或服务端拒绝压缩请求体时，会自动回退到原始 JSON。

Trace Context

trace 默认关闭。开启后 SDK 会生成 base.traceId 和 base.spanId；如果同时开启 propagateTraceparent，只会为 same-origin 或命中 propagationTargets 的 fetch/xhr 请求注入 W3C traceparent header，避免把 trace header 发送到未知第三方域名。

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | trace.enabled | boolean | false | 是否生成 trace 上下文。 | | trace.sampleRate | number | 1 | trace 上下文采样率，范围会被钳制到 0 ~ 1。 | | trace.propagateTraceparent | boolean | false | 是否向 fetch/xhr 请求注入 traceparent。 | | trace.propagationTargets | Array<string \| RegExp> | [] | 允许跨域传播 traceparent 的目标；same-origin 请求无需配置。 | | trace.tracesSampler | (context) => number \| boolean | 无 | 动态 trace 采样函数，返回布尔值或 0 ~ 1 采样率。 |

可以用轻量 span API 把业务操作与请求事件关联起来：

const transaction = startTransaction("checkout", { op: "navigation" })
const span = startSpan("submit", { op: "ui.action" })

await withSpan(span, async () => {
  await fetch("/api/orders")
})

span.finish()
transaction.finish()

SDK 自诊断

getDiagnostics() 会返回 SDK 运行期计数快照，便于接入方确认采样、队列、payload 大小和离线重试行为：

const diagnostics = getDiagnostics()
console.log(diagnostics.droppedByPayloadSize)

当前字段包括：droppedBySampling、droppedByQueueOverflow、droppedByPayloadSize、offlineQueued、retrySucceeded、retryExhausted。

Web Vitals 发送时机

FCP / TTFB 会在页面加载完成后以 performanceType: "web_vital" 单独发送，同时仍保留 navigation metrics。
LCP / CLS / INP 会在页面隐藏、页面退出，或最多约 10 秒后的兜底 flush 时发送。
SPA soft navigation 的 LCP / CLS / INP 也会在路由切换结束后进入同样的兜底 flush。

Session Replay

sessionReplay 用于开启录屏分片采集，支持持续全量录制和基于错误触发的窗口录制两种模式。

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | sessionReplay | boolean \| SessionReplayOptions | false | 传 true 会启用默认 replay 配置；传对象时可覆盖更细的参数。 |

SessionReplayOptions 子字段：

| 字段 | 默认值 | 说明 | | --- | --- | --- | | enabled | false | 是否启用录屏。 | | endpoint | dsn 自动替换为 /replays/ | replay chunk 上报地址。 | | mode | "error-linked" | "full" 持续录制并分片上传；"error-linked" 仅在命中错误触发器时上传“前后窗口”。 | | sample.fullSessionRate | 0 | full 模式采样率。 | | sample.errorSessionRate | 1 | error-linked 模式采样率。 | | sampleRate | 0 | 兼容旧配置的别名；未显式传 mode 时，会按旧版语义推导为 "full"。 | | flushInterval | 5000 | chunk 定时发送间隔，单位毫秒。 | | maxEvents | 20 | 单个 chunk 最多包含的 rrweb event 数。 | | maxPayloadBytes | 131072 | 单个 replay chunk 最大体积。 | | errorLinked.preTriggerMs | 15000 | 触发错误前保留的回放窗口。 | | errorLinked.postTriggerMs | 15000 | 触发错误后继续录制的窗口。 | | errorLinked.maxTriggersPerSession | 3 | 单个会话最多触发多少次错误关联录制。 | | errorLinked.pageMatcher | [] | 仅当事件发生页命中这些字符串或正则时才触发 replay，可用于把录制成本集中在关键页面。 | | errorLinked.triggerOn | ["js_error", "promise_rejection", "console_error", "request_error"] | 哪些错误事件会触发 error-linked replay。 | | errorLinked.requestError.statusRanges | ["5xx"] | request_error 默认只对 5xx 触发 replay，减少 404 等业务噪音。 | | errorLinked.requestError.statusCodes | [] | 额外放行的具体状态码。 | | errorLinked.requestError.includeNetworkErrors | true | 是否对无状态码的网络失败触发 replay。 | | errorLinked.requestError.includeTimeouts | true | 是否对 timeout 触发 replay。 | | errorLinked.requestError.includeAborts | false | 是否对 abort 触发 replay。默认关闭，避免用户主动取消操作造成噪音。 | | errorLinked.consoleError.includePatterns | [] | console_error 只有命中这些字符串或正则时才触发 replay。为空时表示不额外收窄。 | | errorLinked.consoleError.excludePatterns | [] | console_error 命中这些字符串或正则时不触发 replay，可用于屏蔽已知浏览器噪音。 | | errorLinked.resourceError.resourceTypes | [] | 仅允许这些资源类型触发 replay，例如 ["script", "link"]。为空时不限制。 | | errorLinked.resourceError.urlPatterns | [] | resource_error 只有命中这些字符串或正则时才触发 replay。匹配目标是结构化的 resourceUrl 字段。 | | privacy.maskAllInputs | true | 是否对输入框内容做 rrweb 级别脱敏。 | | privacy.blockClass | "" | 透传给 rrweb 的 blockClass。 | | privacy.blockSelector | "" | 透传给 rrweb 的 blockSelector。 | | privacy.ignoreClass | "" | 透传给 rrweb 的 ignoreClass。 | | privacy.ignoreSelector | "" | 透传给 rrweb 的 ignoreSelector。 | | privacy.maskTextClass | "" | 透传给 rrweb 的文本脱敏 class。 | | privacy.maskTextSelector | "" | 透传给 rrweb 的文本脱敏 selector。 | | privacy.maskInputOptions | {} | 透传给 rrweb 的输入类型脱敏配置。 | | privacy.slimDOMOptions | {} | 透传给 rrweb 的 DOM 精简配置。 | | canvas.enabled | false | 是否开启 canvas 相关录制配置。 | | canvas.recordCanvas | false | 是否让 rrweb 录制 canvas。 | | canvas.samplingInterval | 100 | canvas 采样间隔，单位毫秒。 |

启用后：

base.replayId 会自动附带到普通事件 payload
captureError() 产生的错误事件可以在后端关联回放
可通过 getReplayId() 获取当前会话 replay 标识
可通过 startReplay()、pauseReplay()、resumeReplay()、stopReplay({ flush }) 主动控制 replay
可通过 addReplayEvent(tag, payload) 写入 SDK 自定义 timeline 事件
replay chunk 发送失败会优先写入 IndexedDB 持久化队列，后续 flushSessionReplay()、页面退出或重新初始化后会再次尝试。

示例：

init({
  dsn: "https://example.com/api/v1/monitor/collect/demo",
  appName: "demo",
  sessionReplay: {
    enabled: true,
    mode: "error-linked",
    sample: {
      fullSessionRate: 0,
      errorSessionRate: 1
    },
    errorLinked: {
      pageMatcher: [/\/checkout/],
      preTriggerMs: 15000,
      postTriggerMs: 15000,
      maxTriggersPerSession: 3,
      triggerOn: ["js_error", "request_error"],
      requestError: {
        statusRanges: ["5xx"],
        includeNetworkErrors: true,
        includeTimeouts: true
      },
      consoleError: {
        excludePatterns: ["ResizeObserver loop limit exceeded"],
        includePatterns: ["checkout failed"]
      },
      resourceError: {
        resourceTypes: ["script"],
        urlPatterns: [/critical\.js/]
      }
    },
    privacy: {
      maskAllInputs: true,
      blockClass: "fm-block",
      ignoreClass: "fm-ignore"
    }
  }
})

错误聚合

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | scopeError | boolean | false | 开启后，会对部分重复错误做短窗口聚合，减少循环报错对上报量的冲击。 |

Hook

| 字段 | 类型 | 默认值 | 说明 | | --- | --- | --- | --- | | beforePushEvent | (event) => event \\| event[] \\| false | 无 | 在事件进入队列前执行。可修改、拆分或丢弃单个事件。 | | beforeSend | (payload) => payload \\| false | 无 | 在 payload 真正发送前执行。可统一脱敏、改写字段或阻止本批次发送。 | | afterSend | (result, payload) => void | 无 | 在一次发送结束后执行，可用于记录发送回执、埋点调试或失败告警。 |

Hook 执行顺序：

事件生成
beforePushEvent
入内存队列
组装批量 payload
beforeSend
发送或本地化缓存
afterSend

如果多个 beforePushEvent 连续注册，前一个 hook 返回数组时，后续 hook 会逐个处理数组内事件；某个事件返回 false 只会丢弃当前事件，不影响同数组里的其他事件。

行为说明

1. `sampleRate` 只影响普通事件

track(..., true) 或 captureError(..., true) 这种显式 flush = true 的调用不会经过普通采样丢弃逻辑，适合关键事件。

2. 离线时会进入自动重试队列

检测到浏览器处于 offline 状态或发送失败时，SDK 会在 offlineRetry = true 时把 payload 写入 IndexedDB 重试队列，并在浏览器恢复在线后按退避策略重试；如果当前环境不支持 IndexedDB，则会回退到 localStorage。如果你需要完全手动控制发送时机，可以改用 localization: true 和 sendLocal()。

3. `ignoreUrls` 会自动包含 `dsn`

即使你不手动传 ignoreUrls，SDK 也会自动忽略上报接口自身，避免 request_error 递归采集。

4. `exposure` 开关只控制能力，不会自动扫描 DOM

开启 capture.exposure 后，仍然需要手动调用 intersectionObserver() 注册目标节点：

import { init, intersectionObserver } from "frontend-monitor-core"

init({
  dsn: "/api/v1/monitor/collect/demo-project-key",
  appName: "demo",
  capture: {
    exposure: true
  }
})

intersectionObserver({
  target: document.querySelector("#hero-banner")!,
  threshold: 0.5,
  params: { slot: "hero-banner" }
})

Example

下面是一份更完整的初始化示例：

import {
  afterSend,
  beforePushEvent,
  beforeSend,
  init,
  sendLocal
} from "frontend-monitor-core"

init({
  dsn: "/api/v1/monitor/collect/demo-project-key",
  appName: "us-site-web",
  appVersion: "1.2.3",
  sampleRate: 1,
  batchSize: 10,
  flushInterval: 3000,
  maxQueueLength: 300,
  timeout: 4000,
  debug: true,
  ignoreUrls: [/\\/health$/, "/api/internal/no-track"],
  localization: false,
  scopeError: true,
  sanitize: {
    sensitiveKeys: ["secretCode"],
    textPatterns: [/order_[0-9]+/g]
  },
  trace: {
    enabled: true,
    propagateTraceparent: true,
    sampleRate: 1
  },
  capture: {
    performance: true,
    requestPerformance: true,
    exposure: true
  }
})

beforePushEvent((event) => {
  if (event.type === "click" && event.selector.includes(".ignore-track")) {
    return false
  }
  return event
})

beforeSend((payload) => {
  return {
    ...payload,
    base: {
      ...payload.base,
      appVersion: payload.base.appVersion ?? "unknown"
    }
  }
})

afterSend((result, payload) => {
  console.log("monitor send result", result, payload.events.length)
})

void sendLocal()

Type Source

如果你要核对配置的真实类型定义，源码以这里为准：

更多仓库级说明见：

https://github.com/luorixin/frontendMonitor#readme
https://github.com/luorixin/frontendMonitor/blob/master/docs/release.md

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

frontend-monitor-core

Install

Quick Start

Tree-shaking Friendly Usage

Source Layout

Main APIs

Integrations

MonitorOptions

必填字段

基础信息

队列与发送

采集开关

本地化缓存

诊断上下文

错误诊断字段

请求体采集

脱敏配置

自定义传输

Trace Context

SDK 自诊断

Web Vitals 发送时机

Session Replay

错误聚合

Hook

行为说明

1. sampleRate 只影响普通事件

2. 离线时会进入自动重试队列

3. ignoreUrls 会自动包含 dsn

4. exposure 开关只控制能力，不会自动扫描 DOM

Example

Type Source

1. `sampleRate` 只影响普通事件

3. `ignoreUrls` 会自动包含 `dsn`

4. `exposure` 开关只控制能力，不会自动扫描 DOM