从 6.x 升级到 7.x

了解如何从 Sentry JavaScript SDK 6.x 升级到 7.x

Sentry JavaScript SDK 的 v7 版本要求使用自托管版本的 Sentry 20.6.0 或更高版本。

v7 版本的主要目标是减少包体积。由于我们移除了已弃用的 API、升级了构建工具并重构了 npm 包的内容,因此这是一个破坏性更新。以下列出了您在升级时应考虑的所有破坏性更改。

TL;DR 如果您只使用 Sentry 的基本功能,或者只是复制并粘贴了我们文档中的设置示例,以下是针对您的更改:

  • 如果您安装了其他 Sentry 包(例如 @sentry/tracing),请确保将它们与您的 Sentry SDK(如 @sentry/react@sentry/node)一起升级到版本 7。
  • 我们的 CDN 包现已为 ES6 - 如果您希望继续支持 ES5 和 IE11,请重新配置您的脚本标签以适应新 SDK 版本。
  • 分发的 CommonJS 文件将是 ES6。如果您需要支持旧版 Node.js,请使用转译器。
  • 我们生成类型所使用的 TypeScript 版本已升级到 3.8.3。请检查使用 TypeScript 3.7 或更低版本的 TypeScript 项目是否仍能编译。否则,请升级您的 TypeScript 版本。
  • whitelistUrlsblacklistUrls 已重命名为 allowUrlsdenyUrls,位于 Sentry.init() 选项中。
  • UserAgent 集成现在称为 HttpContext
  • 如果您启用了追踪功能,可能需要调整服务器的 CORS 设置。

有关从 6.x 升级到 7.x 的更多信息,请参阅我们的 详细迁移指南