@babel/plugin-transform-react-jsx-self

What is @babel/plugin-transform-react-jsx-self?

The @babel/plugin-transform-react-jsx-self plugin is used with Babel to transform JSX code in React. It adds a __self attribute to JSX elements which is used by React for development tools to provide more informative error messages and warnings. This attribute includes a reference to the component that created each element, which can be helpful for debugging purposes.

What are @babel/plugin-transform-react-jsx-self's main functionalities?

Adding __self attribute to JSX elements

This feature automatically adds a __self attribute to every JSX element, which is set to 'this' (the current React component instance). This is useful for React's development mode error messages and warnings, as it helps identify which component the JSX element came from.

class MyComponent extends React.Component {
  render() {
    return <div>Hello, world!</div>;
  }
}

// Transformed JSX with @babel/plugin-transform-react-jsx-self
// <div __self={this}>Hello, world!</div>

Other packages similar to @babel/plugin-transform-react-jsx-self

@babel/plugin-transform-react-jsx

This plugin transforms JSX syntax into createElement calls. It is similar to @babel/plugin-transform-react-jsx-self but does not automatically add the __self attribute. It is a more general JSX transformation plugin.

@babel/plugin-transform-react-jsx-source

Similar to @babel/plugin-transform-react-jsx-self, this plugin adds source information to JSX elements by adding a __source attribute. This includes the file name and line number of the JSX element, which is also useful for debugging. It complements the __self attribute by providing additional context about where the element was defined.

react-hot-loader

While not a Babel plugin, react-hot-loader is a package that enables hot reloading for React components. It also helps with debugging by preserving the internal state of components when the code is updated. It's similar in the sense that it enhances the development experience, but it does not modify the JSX syntax like @babel/plugin-transform-react-jsx-self.

README

@babel/plugin-transform-react-jsx-self

Adds __self prop to JSX elements, which React will use to generate some runtime warnings. All React users should enable this transform in dev mode.

Example

In

<sometag />

Out

<sometag __self={this} />

Installation

npm install --save-dev @babel/plugin-transform-react-jsx-self

Usage

Via .babelrc (Recommended)

.babelrc

{
  "plugins": ["@babel/plugin-transform-react-jsx-self"]
}

Via CLI

babel --plugins @babel/plugin-transform-react-jsx-self script.js

Via Node API

require("@babel/core").transform("code", {
  plugins: ["@babel/plugin-transform-react-jsx-self"]
});