从 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
。请检查使用 TypeScript3.7
或更低版本的 TypeScript 项目是否仍能编译。否则,请升级您的 TypeScript 版本。 whitelistUrls
和blacklistUrls
已重命名为allowUrls
和denyUrls
,位于Sentry.init()
选项中。UserAgent
集成现在称为HttpContext
。- 如果您启用了追踪功能,可能需要调整服务器的 CORS 设置。
有关从 6.x
升级到 7.x
的更多信息,请参阅我们的 详细迁移指南。