@sentry/babel-plugin-component-annotate

Sentry Babel Component Annotate Plugin

A Babel plugin that automatically annotates your output DOM with their respective frontend component names. This will unlock the capability to search for Replays in Sentry by component name, as well as see component names in breadcrumbs and performance monitoring. Please note that your Sentry JavaScript SDK version must be at least 7.91.0 to take advantage of these features. Currently, this plugin only works with React, and will exclusively parse .jsx and .tsx files.

Note

This plugin comes included in Sentry's bundler plugins, alongside many other features to improve your Sentry workflow. It can be downloaded individually, but it is recommended that you install the bundler plugins for your respective bundler, and enable this feature through the config object.

Check out the supported bundler plugin packages for installation instructions:

• Rollup
• Vite
• Webpack
• esbuild: Not currently supported

Installation

Using npm:

npm install @sentry/babel-plugin-component-annotate --save-dev

Using yarn:

yarn add @sentry/babel-plugin-component-annotate --dev

Using pnpm:

pnpm add @sentry/babel-plugin-component-annotate --save-dev

Options

ignoredComponents

Type: string[]

A list of strings representing the names of components to ignore. The plugin will not apply data-sentry annotations on the DOM element for these components.

Example

// babel.config.js

{
  // ... other config above ...

  plugins: [
    // Put this plugin before any other plugins you have that transform JSX code
    // The options are set by providing an object as the second element in the array, but not required
    ['@sentry/babel-plugin-component-annotate', {ignoredComponents: ['Foo', 'Bar']}]
  ],
}

Or alternatively, configure the plugin by directly importing it:

// babel.config.js

import componentNameAnnotatePlugin from '@sentry/babel-plugin-component-annotate';

{
  // ... other config above ...

  plugins: [
    // Put this plugin before any other plugins you have that transform JSX code
    [componentNameAnnotatePlugin]
  ],
}

More information

• Sentry Documentation
• Sentry Discord
• Sentry Stackoverflow

Changelog

2.23.0

• chore(deps): bump nanoid from 3.3.6 to 3.3.8 (#641)
• feat(core): Detect Railway release name (#639)
• feat(core): Write module injections to globalThis (#636)
• feat(react-component-annotate): Allow skipping annotations on specified components (#617)
• ref(core): Rename release management plugin name (#647)

Work in this release contributed by @conor-ob. Thank you for your contribution!