SuperAPI AI 工具集

upgrade-browser-sdk-v7

部署与运维

查看项目

更新于 10-15 20:33

技能介绍

用途:指导把 Datadog Browser SDK 从 v6 迁移到 v7,按步骤 1-6 顺序执行,每步附带用于定位受影响代码的搜索模式。

主要能力与使用方式:

  1. 更新 SDK 版本。CDN 场景将脚本 URL 中的 v6 换成 v7,并替换站点前缀(us1、eu1、us3、us5、ap1、ap2;US1-FED 为无站点前缀的 datadog-rum-v7.js)。npm 场景把 @datadog/browser-rum、@datadog/browser-logs、@datadog/browser-rum-slim 依赖更新为 ^7.0.0,并升级 React、Angular、Vue、Next.js 等框架集成到 v7,随后重新安装并构建。
  2. CDN 场景需为所有加载 SDK 的 script 标签添加 crossorigin="anonymous",动态创建脚本时也要在设置 src 前设置 crossOrigin。
  3. 删除已废弃选项:betaEncodeCookieOptions 直接删除;allowFallbackToLocalStorage 替换为 sessionPersistence: ['cookie', 'local-storage'];RUM 的 trackBfcacheViews、trackEarlyRequests、betaTrackActionsInShadowDom 和 Logs 的 usePciIntake 均删除。
  4. 更新变更的 API:Logs 中 forwardErrorsToLogs 与 forwardConsoleLogs 已独立,如需保留 v6 行为要显式在 forwardConsoleLogs 加入 'error';RUM 的 startDurationVital/stopDurationVital 以 vitalKey 字符串替代 DurationVitalReference 对象;插件 API 移除 strategy 字段。
  5. 了解行为变更:默认隐私级别改为 mask-user-input、enablePrivacyForActionName 默认 true、propagateTraceBaggage 默认 true、确定性采样、移除 FID、视图加载类型与会话续期相关变化、文档资源 initiatorType 改变、动作名称可能变化、取消请求错误不再记录、Logs 必须使用会话存储、Session Replay 变更记录格式、异步 chunk 名以 datadog 为前缀。
  6. 更新基础设施:CSP 需允许 crossorigin 与新 chunk 名,Cookie 需加入 _dd_s_v2(SDK 首次加载自动从 _dd_s 迁移),CORS 在 tracing 源添加 baggage 头或关闭 propagateTraceBaggage;浏览器最低支持 Chrome 80+、Firefox 78+、Safari 14+。

限制:本资料为 v6 到 v7 的迁移指引,按步骤与搜索命令执行;未提供未提及的功能、收费或价格信息。