@babel/helper-compilation-targets

What is @babel/helper-compilation-targets?

The @babel/helper-compilation-targets package is a helper utility used by Babel to determine which JavaScript language features need to be transformed based on the specified compilation targets, such as browsers or Node.js versions. It helps in generating the most efficient and compatible code for the specified environments.

What are @babel/helper-compilation-targets's main functionalities?

Determining necessary plugins/presets

This feature allows you to determine which Babel plugins or presets are necessary to transform your code based on the specified target environments, such as the last two versions of all browsers or Safari versions greater than 7.

const { default: getTargets, filterItems } = require('@babel/helper-compilation-targets');

const targets = getTargets({
  browsers: ['last 2 versions', 'safari > 7']
});

const plugins = filterItems(
  require('@babel/preset-env/data/plugins'),
  targets,
  { ignoreBrowserslistConfig: true }
);

Customizing target environments

This feature enables customization of the target environments for which you are compiling your code. For example, you can specify that you want to target environments that support ES modules or the current version of Node.js.

const { default: getTargets } = require('@babel/helper-compilation-targets');

const targets = getTargets({
  esmodules: true,
  node: 'current'
});

Other packages similar to @babel/helper-compilation-targets

browserslist

The browserslist package is used to share target browsers and Node.js versions between different front-end tools. It is similar to @babel/helper-compilation-targets in that it helps determine the set of browsers to support for tools like Autoprefixer, eslint-plugin-compat, and stylelint-unsupported-browser-features. However, it is a more general tool and not specific to Babel.

core-js-compat

core-js-compat provides information about compatibility and required polyfills for different environments. It is similar to @babel/helper-compilation-targets in that it helps to determine which features need to be polyfilled based on the target environment. However, core-js-compat focuses on polyfills provided by core-js rather than Babel transformations.

README

@babel/helper-compilation-targets

Helper functions on Babel compilation targets

See our website @babel/helper-compilation-targets for more information.

Install

Using npm:

npm install --save @babel/helper-compilation-targets

or using yarn:

yarn add @babel/helper-compilation-targets

Changelog

v7.22.10 (2023-08-07)

:bug: Bug Fix

• babel-plugin-transform-typescript
  • #15799 [ts] Strip type-only namespaces (@nicolo-ribaudo)
  • #15798 [ts] Fix compiling extended exported nested namespace (@nicolo-ribaudo)
• babel-helper-create-class-features-plugin, babel-plugin-proposal-decorators, babel-plugin-proposal-destructuring-private, babel-plugin-transform-class-properties, babel-plugin-transform-class-static-block, babel-plugin-transform-new-target, babel-plugin-transform-private-methods, babel-preset-env
  • #15701 Memoize class binding when compiling private methods and static elements (@JLHwung)

:nail_care: Polish

• babel-cli
  • #15824 Add meta object to @babel/eslint-plugin (@JLHwung)
• babel-traverse, babel-types
  • #15661 Improve the type definition of path.isX (@liuxingbaoyu)
• babel-generator, babel-types
  • #15776 improve SourceLocation typing (@JLHwung)

:house: Internal

• Other
  • #15818 build: generate flow typings in prepublish job (@JLHwung)
  • #15777 chore: bump dev dependencies and remove .eslintignore (@JLHwung)
• babel-cli, babel-core, babel-generator, babel-helper-builder-react-jsx, babel-preset-env, babel-standalone
  • #15794 Enable @typescript-eslint/no-redundant-type-constituents rule (@JLHwung)
• babel-helper-compilation-targets
  • #15811 Remove @babel/core peerDep from helper-compilation-targets (@nicolo-ribaudo)
• babel-parser
  • #15793 Use const enum in babel-parser (@JLHwung)
• babel-plugin-transform-runtime, babel-traverse, babel-types
  • #15716 chore: Use typescript-eslint@v6 with reworked configs (@JoshuaKGoldberg)

:microscope: Output optimization

• babel-plugin-transform-block-scoping, babel-plugin-transform-parameters, babel-plugin-transform-regenerator
  • #15746 Reduce transform-block-scoping loops output size (@liuxingbaoyu)