Tree Shaking

Sentry SDK 以多种方式支持 tree shaking。为了充分利用现代打包工具（如 webpack 或 Rollup）的 tree shaking 功能，需要应用一些额外的配置。如果您希望最小化 Sentry SDK 的打包大小，我们建议阅读本页面并按照所示应用 tree shaking 配置。

可选代码的 Tree Shaking

Sentry SDK 包含了一些并非严格必需的代码，例如用于调试您的 Sentry 配置或启用跟踪的代码。虽然调试代码在开发环境中非常有用，但在生产环境中通常不需要包含这些代码，因为它们会占用宝贵的打包空间。JavaScript SDK 在其 CommonJS 和 ESM 发行版中包含了特殊的标志，可以在构建过程中帮助 tree shaking（移除）这类代码。

手动 Tree Shaking

如果您希望 tree shake 可选代码，可以通过替换 Sentry SDK 中的各种标志来从构建输出中移除这些代码。请注意，如果您已经通过 Sentry 打包工具插件配置了 tree shaking，则无需手动执行此操作——插件会为您处理。

以下标志可用：

__SENTRY_DEBUG__

将此标志替换为 false 将 tree shake 与调试日志相关的所有 SDK 代码。

__SENTRY_TRACING__

将此标志替换为 false 将 tree shake 与跟踪相关的所有 SDK 代码。

如果未添加 browserTracingIntegration，这将不起作用。

__RRWEB_EXCLUDE_IFRAME__

将此标志替换为 true 将 tree shake 与 Session Replay 捕获 iframe 内容相关的所有 SDK 代码。仅在使用 Session Replay 时相关。如果您不想记录任何 iframe，请启用此标志。如果未添加 replayIntegration，这将不起作用。

__RRWEB_EXCLUDE_SHADOW_DOM__

将此标志替换为 true 将 tree shake 与 Session Replay 捕获 shadow DOM 元素相关的所有 SDK 代码。仅在使用 Session Replay 时相关。如果您不想记录任何 shadow DOM 元素，请启用此标志。如果未添加 replayIntegration，这将不起作用。

__SENTRY_EXCLUDE_REPLAY_WORKER__

将此标志替换为 true 将 tree shake 与 Session Replay 包含的压缩 Web Worker 相关的所有 SDK 代码。仅在使用 Session Replay 时相关。如果您希望自行托管压缩 Worker，请启用此标志。详情请参阅 使用自定义压缩 Worker。除非您提供了自定义 Worker URL，否则不建议启用此标志。 如果未添加 replayIntegration，这将不起作用。

Tree Shaking 默认集成

默认情况下，Sentry SDK 会设置一组 默认集成，以扩展您的 SDK 功能。您还可以在 SDK 配置中添加 其他 或 自定义 集成。 如果您不希望在配置中包含默认集成，可以通过 禁用 它们并添加您自定义的集成数组来实现。 然而，如果您还想 tree shake 未使用的默认集成，可以通过自己创建一个 Client 来实现。通过这样做，您可以绕过通常为您创建 Client 的 Sentry.init。

以下示例展示了如何创建并绑定一个 Client，从而启用对未使用默认集成的 tree shaking：

import {
  BrowserClient,
  breadcrumbsIntegration,
  dedupeIntegration,
  defaultStackParser,
  getCurrentScope,
  globalHandlersIntegration,
  makeFetchTransport,
  linkedErrorsIntegration,
} from "@sentry/browser";

const client = new BrowserClient({
  // all options you normally pass to Sentry.init
  dsn: "your DSN",
  // ...
  transport: makeFetchTransport,
  stackParser: defaultStackParser,
  // Only the integrations listed here will be used
  integrations: [
    breadcrumbsIntegration(),
    globalHandlersIntegration(),
    linkedErrorsIntegration(),
    dedupeIntegration(),
  ],
});

getCurrentScope().setClient(client);
client.init();