用途:将 Datadog Browser SDK 从 v6 迁移到 v7,按步骤 1-6 顺序执行,每步附搜索模式定位受影响代码。
主要能力:更新 CDN 脚本 URL(如 datadoghq-browser-agent.com/us1/v6/datadog-rum.js 改为 v7,站点前缀支持 eu1、us3、us5、ap1、ap2,US1-FED 为无前缀的 datadog-rum-v7.js)及 npm 依赖(@datadog/browser-rum、browser-logs、browser-rum-slim 升至 ^7.0.0,并升级 React/Angular/Vue/Next.js 集成);为 CDN script 添加 crossorigin="anonymous";删除废弃选项(betaEncodeCookieOptions、trackBfcacheViews、trackEarlyRequests、betaTrackActionsInShadowDom、usePciIntake),allowFallbackToLocalStorage 改为 sessionPersistence: ['cookie', 'local-storage'];调整 forwardErrorsToLogs 与 forwardConsoleLogs 的独立行为;将 startDurationVital/stopDurationVital 从引用对象改为 vitalKey 字符串(返回 void);处理插件 API 移除 strategy。
使用方式:按步骤执行 grep 搜索定位代码,逐项替换;升级后核对验证清单,包括 SDK 无控制台错误、crossorigin 属性、无废弃选项、Session Replay 与分布式追踪正常、Cookie 由 _dd_s 迁移为 _dd_s_v2、动作名称符合新隐私默认值、无变量捕获 startDurationVital 返回值。
适用场景:使用 Datadog RUM 或 Logs 浏览器 SDK 的前端项目升级。
限制:需注意行为变化,如 defaultPrivacyLevel 默认改为 mask-user-input、enablePrivacyForActionName 默认 true、propagateTraceBaggage 默认 true(需 CORS 允许 baggage 头)、FID 移除改用 INP、异步 chunk 名带 datadog 前缀需更新 CSP、最低浏览器支持 Chrome 80+/Firefox 78+/Safari 14+。具体版本细节以官方资料为准。