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

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

The @babel/plugin-transform-react-jsx-source plugin is used with Babel to transform JSX code. It adds source file and line number information to JSX elements, which can be very helpful for debugging purposes. When a React component throws an error, this plugin makes it easier to trace back to the source code where the problematic component was defined.

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

Adding source and line number to JSX elements

This code snippet demonstrates a simple React component. When using @babel/plugin-transform-react-jsx-source, Babel will transform this JSX to include source file and line number information. This doesn't change the behavior of the component but enhances the debugging experience by indicating where each element was defined in the source code.

const MyComponent = () => (
  <div>
    <h1>Hello, world!</h1>
  </div>
);

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

@babel/plugin-transform-react-jsx

Similar to @babel/plugin-transform-react-jsx-source, this plugin transforms JSX into createElement calls but does not add source and line number information. It's more focused on the transformation itself rather than enhancing the debugging experience.

react-hot-loader

While not a direct alternative, react-hot-loader provides hot reloading for React components during development. It enhances the development experience by allowing live updates without losing state. It complements the functionality of @babel/plugin-transform-react-jsx-source by improving the overall development workflow rather than focusing solely on debugging.

README

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

Adds source file and line number to JSX elements.

Example

In

<sometag />

Out

<sometag __source={ { fileName: 'this/file.js', lineNumber: 10 } } />

Installation

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

Usage

Via .babelrc (Recommended)

.babelrc

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

Via CLI

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

Via Node API

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