Sentry 官方 JavaScript SDK 简介与调试指南

https://github.com/getsentry/sentry-javascript

对于每个主要的 JavaScript 平台，都有一个特定的高阶 SDK，可以在单个包中提供您需要的所有工具。有关更多详细信息，请参阅这些 SDK 的 README 和说明：

@sentry/browser: 浏览器的 SDK，包括对基础主干(GlobalHandlers, TryCatch, Breadcrumbs, LinkedErrors, UserAgent, Dedupe)的集成。
@sentry/node: 适用于 Node 的 SDK，包括 Express、Koa、Loopback、Sails 和 Connect 的集成。
@sentry/angular: 启用 Angular 集成的浏览器 SDK。
@sentry/react: 启用 React 集成的浏览器 SDK。
@sentry/ember: 启用 Ember 集成的浏览器 SDK。
@sentry/vue: 启用 Vue 集成的浏览器 SDK。
@sentry/gatsby: Gatsby 的 SDK。
@sentry/nextjs: Next.js 的 SDK。
@sentry/integrations: 可用于增强 JS SDK 的可插拔集成。
@sentry/electron: 支持原生崩溃的 Electron SDK。
@sentry/react-native: 支持原生崩溃的 React Native SDK。
@sentry/capacitor:支持原生崩溃的 Capacitor App 和 Ionic 的 SDK。
sentry-cordova:支持原生崩溃的 Cordova App 的 SDK。
raven-js:旧的稳定 JavaScript SDK，我们仍然支持并发布 SDK 的错误修复，但所有新功能都将在 @sentry/browser 中实现，它是继任者。
raven:旧的稳定 Node SDK，与 raven-js 一样，我们仍然支持并发布 SDK 的错误修复，但所有新功能都将在 @sentry/node 中实现，它是继任者。

设置环境

要运行 test suite 和 code linter，需要 node.js 和 yarn。

sentry-javascript 是一个包含多个软件包的 monorepo，使用 lerna 管理它们。首先，安装所有依赖项，使用 lerna 引导工作区，然后执行初始构建，以便 TypeScript 可以读取所有链接的类型定义。

这样，repo 就完全设置好了，您可以运行所有命令了。

构建软件包

由于我们使用的是 TypeScript，因此您需要将代码转换为 JavaScript 才能使用它。来自 repo 的顶层，有三个可用命令：

yarn build:dev，它运行每个包的 ES5 和 ES6 版本的一次性构建。
yarn build:dev:filter ，它只在与给定包相关的项目中运行 yarn build:dev(例如，运行 yarn build:dev:filter @sentry/react 将构建 react 包、它的所有依赖项(utils、core、browser 等)，以及所有依赖它的包(目前是 gatsby 和 nextjs))。
yarn build:dev:watch，在 watch 模式下运行 yarn build:dev(推荐)

添加测试

任何重要的修复/功能都应该包括测试。您会在每个软件包中找到一个 test 文件夹。

请注意，仅对于 browser 包，如果您将新文件添加到集成测试套件中，您还需要将其添加到shell.js 中的列表中。在所有包中，向现有文件添加测试都可以开箱即用。

运行测试

运行测试与构建的工作方式相同 - 在项目根目录运行 yarn test 将对所有包运行测试，在特定包中运行 yarn test 将为该包运行测试。还有一些命令可以在每个位置运行测试的子集。查看相应 package.json 的 scripts 条目以了解详细信息。

注意：你必须在 yarn test 工作之前运行 yarn build。

调试测试

如果您在编写测试时遇到麻烦并需要调试其中之一，您可以使用 VSCode 的 debugger 来完成。

如果您尚未安装它，请安装 Tasks Shell Input 扩展，您可以在侧边栏的“扩展”选项卡中找到它作为推荐的工作区扩展之一。