@wordpress/babel-preset-default

Babel Preset Default

Default Babel preset for WordPress development.

The preset includes configuration which enable language features and syntax extensions targeted for support by WordPress. This includes ECMAScript proposals which have reached Stage 4 ("Finished"), as well as the JSX syntax extension. For more information, refer to the JavaScript Coding Guidelines.

Installation

Install the module

npm install @wordpress/babel-preset-default --save-dev

Usage

There are a number of methods to configure Babel. See Babel's Configuration documentation for more information. To use this preset, simply reference @wordpress/default in the presets option in your Babel configuration.

For example, using .babelrc:

{
  "presets": [ "@wordpress/default" ]
}

Extending Configuration

This preset is an opinionated configuration. If you would like to add to or change this configuration, you can do so by expanding your Babel configuration to include plugins or presets which override those included through this preset. It may help to familiarize yourself the implementation of the configuration to see which specific plugins are enabled by default through this preset.

For example, if you'd like to use a new language feature proposal which has not reached the stability requirements of WordPress, you can add those as additional plugins in your Babel configuration:

{
  "presets": [ "@wordpress/babel-preset-default" ],
  "plugins": [ "@babel/plugin-proposal-class-properties" ]
}