Skip to content

配置项参考 ​

init(options) 支持的完整选项:

公共(Web / 小程序通用) ​

选项类型默认说明
appIdstring必填应用标识(管理后台创建)
dsnstring必填采集接口地址
tokenstring必填写入 token,随 x-monitor-token 请求头上报;缺失/错误时服务端返回 403,数据不入库
releasestringunknown版本号,与 sourcemap 上传一致
envstringproduction环境标记;管理后台可按环境筛选错误/性能/行为数据,告警规则也可限定环境
userIdstring-初始用户标识(也可 client.setUser())
maxBreadcrumbsnumber20面包屑环形缓冲容量
maxBatchnumber10攒够多少条立即上报
flushIntervalnumber5000定时冲刷间隔(ms)

Web 专属 ​

选项类型默认说明
breadcrumbsbooleantrue点击/路由面包屑
performanceboolean | objecttrueWeb Vitals / 长任务 / 慢资源;对象可配 sampleRate(采样率 0~1)与 slowResourceThreshold
trackboolean | objecttruePV / 停留 / 点击;对象可配 pageview / pageDuration / click / collectText(元素文本默认不采,隐私)
whiteScreenboolean | objectfalse白屏检测(load 后延迟采样,稀疏页面有误报风险,显式开启);对象可配 delay / containerSelectors

env 缺省时 Web SDK 会尝试从宿主构建环境推断:Vite 应用取 import.meta.env.MODE(dev→development、build→production、自定义 --mode 原样透传),webpack/Next 等取 process.env.NODE_ENV;都推断不到才回落 production。显式 env(含 data-env)始终优先于推断。

ts
init({
  appId: 'my-app',
  dsn: '…',
  performance: { sampleRate: 0.1 },   // 性能数据 10% 采样
  track: { click: true, collectText: false },
  whiteScreen: { delay: 3000, containerSelectors: ['#app'] },
});

小程序专属 ​

小程序端选项即公共选项。采集能力(Page/request 劫持)默认全开,无需配置。