Babel preset that automatically determines the correct babel plugins to use based on the provided environments.

npm install babel-preset-env --save-dev

// .babelrc
{
  "presets": [
    ["env", {
      "targets": {
        "chrome": 54
      }
    }]
  ]
}

• How it Works
• Install
• Usage
• Options
• Examples
• Caveats

#7 - Use external data such as compat-table to determine browser support. (We should create PRs there when necessary)

We can periodically run build-data.js which generates plugins.json.

Currently located at pluginFeatures.js.

This should be straightforward to do in most cases. There might be cases were plugins should be split up more or certain plugins aren't standalone enough (or impossible to do).

Default behavior without options is the same as babel-preset-latest.

#14 - It won't include stage-x plugins. env will support all plugins in what we consider the latest version of Javascript (by matching what we do in babel-preset-latest).

Support a node option "node": "current" to only compile for the current running node version.

If you are targeting IE 8 and Chrome 55 it will include all plugins required by IE 8 since you would need to support both still.

#19 - Use browserslist to also queries like > 1%, last 2 versions.

$ npm install --save-dev babel-preset-env

The default behavior without options runs all transforms (acts as babel-preset-latest).

{
  "presets": ["env"]
}

Defaults to {}.

Takes an object of environment versions to support. Each target environment takes a number (you can specify a decimal like node: 6.5)

Example environments: "chrome, edge, firefox, safari, ie, ios, node".

The data for this is currently at: /data/plugins.json and being generated by /scripts/build-data.js using https://kangax.github.io/compat-table.

node: number | "current" | true

If you want to compile against the current node version, you can specify "node": true or "node": "current" which would be the same as node": parseFloat(process.versions.node)

A query to select browsers (ex: last 2 versions, > 5%) using browserslist.

Note, browsers' results are overridden by explicit items from targets.

Defaults to false. Enable "loose" transformations for any plugins in this preset that allow them.

Defaults to "commonjs". Enable transformation of ES6 module syntax to another module type. Can be false to not transform modules.

Defaults to false console.log out the targets and plugins being used as well as the version specified in /data/plugins.json.

Defaults to [] Enable a whitelist of plugins to always include.

Useful if there is a bug in a native implementation, or a combination of a non-supported feature + a supported one doesn't work.

Ex: Node 4 supports native classes but not spread.

Defaults to false.

A way to apply babel-preset-env for polyfills (via "babel-polyfill").

npm install babel-polyfill --save

This option will apply a new plugin that replaces the statement import "babel-polyfill" or require("babel-polyfill") with individual requires for babel-polyfill based on environment.

NOTE: Only use require("babel-polyfill"); once in your whole app. One option is to create single entry file that only contains the require statement.

In

import "babel-polyfill";

Out (different based on environment)

import "core-js/modules/es6.typed.data-view";
import "core-js/modules/es6.reflect.apply";
import "core-js/modules/es6.reflect.own-keys";
import "core-js/modules/es6.symbol.iterator";
import "core-js/modules/es6.symbol.species";
import "core-js/modules/es6.array.from";

// src
export class A {}

// target chrome 52
{
  "presets": [
    ["env", {
      "targets": {
        "chrome": 52
      }
    }]
  ]
}

// ...

class A {}
exports.A = A;

// target chrome 52 with webpack 2/rollup and loose mode
{
  "presets": [
    ["env", {
      "targets": {
        "chrome": 52
      },
      "modules": false,
      "loose": true
    }]
  ]
}

// ...

export class A {}

// using browserslist
{
  "presets": [
    ["env", {
      "targets": {
        "chrome": 52,
        "browsers": ["last 2 versions", "safari 7"]
      }
    }]
  ]
}

// ...

export var A = function A() {
  _classCallCheck(this, A);
};

// process.versions.node -> 6.9.0
{
  "presets": [
    ["env", {
      "targets": {
        "node": "current"
      }
    }]
  ]
}

// ...

class A {}
exports.A = A;

Using targets: {
  "node": 6.5
}

Using plugins:

module: false
transform-exponentiation-operator {}
transform-async-to-generator {}
syntax-trailing-function-commas {}

// target chrome 52 with whitelist on arrow functions
{
  "presets": [
    ["env", {
      "targets": {
        "chrome": 52
      },
      "whitelist": ["transform-es2015-arrow-functions"]
    }]
  ]
}

Using plugins:

transform-exponentiation-operator {}
transform-async-to-generator {}
syntax-trailing-function-commas {}
transform-es2015-arrow-functions {}

If you get a SyntaxError: Unexpected token ... error if using the object-rest-spread then make sure the plugin is at v6.19.0.