babel/packages/babel-preset-stage-2
2018-05-14 17:15:44 -07:00
..
2017-03-25 21:46:16 -04:00
2018-05-14 17:15:44 -07:00
2018-04-19 09:08:15 -05:00

@babel/preset-stage-2

Babel preset for stage 2 plugins.

The gist of Stage 2 is:

Stage 2: draft

What is it? A first version of what will be in the specification. At this point, an eventual inclusion of the feature in the standard is likely.

Whats required? The proposal must now additionally have a formal description of the syntax and semantics of the feature (using the formal language of the ECMAScript specification). The description should be as complete as possible, but can contain todos and placeholders. Two experimental implementations of the feature are needed, but one of them can be in a transpiler such as Babel.

Whats next? Only incremental changes are expected from now on.

Install

npm install --save-dev @babel/preset-stage-2

Usage

.babelrc

{
  "presets": ["@babel/preset-stage-2"]
}

Via CLI

babel script.js --presets @babel/preset-stage-2

Via Node API

require("@babel/core").transform("code", {
  presets: ["@babel/preset-stage-2"]
});

Options

loose

boolean, defaults to false.

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

useBuiltIns

boolean, defaults to false.

Will use the native built-in instead of trying to polyfill behavior for any plugins that require one.

decoratorsLegacy

boolean, defaults to false.

Use the legacy (stage 1) decorators syntax and behavior.

References