主题
配置项参考
init(options) 支持的完整选项:
公共(Web / 小程序通用)
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
appId | string | 必填 | 应用标识(管理后台创建) |
dsn | string | 必填 | 采集接口地址 |
token | string | 必填 | 写入 token,随 x-monitor-token 请求头上报;缺失/错误时服务端返回 403,数据不入库 |
release | string | unknown | 版本号,与 sourcemap 上传一致 |
env | string | production | 环境标记;管理后台可按环境筛选错误/性能/行为数据,告警规则也可限定环境 |
userId | string | - | 初始用户标识(也可 client.setUser()) |
maxBreadcrumbs | number | 20 | 面包屑环形缓冲容量 |
maxBatch | number | 10 | 攒够多少条立即上报 |
flushInterval | number | 5000 | 定时冲刷间隔(ms) |
Web 专属
| 选项 | 类型 | 默认 | 说明 |
|---|---|---|---|
breadcrumbs | boolean | true | 点击/路由面包屑 |
performance | boolean | object | true | Web Vitals / 长任务 / 慢资源;对象可配 sampleRate(采样率 0~1)与 slowResourceThreshold |
track | boolean | object | true | PV / 停留 / 点击;对象可配 pageview / pageDuration / click / collectText(元素文本默认不采,隐私) |
whiteScreen | boolean | object | false | 白屏检测(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 劫持)默认全开,无需配置。