Babel 6.x presets for Node 5.x (updated regularly!)

Node 5.x brings ~59% native ES6/ES2015 coverage. This preset for Babel 6 attempts
to bridge the gap for the much of the remaining 41% using Babel plug-ins.

Motivation

Babel 6.x is awesome, but simply including the ES2015 preset means you're transpiling features
that your Node 5.x installation can already do faster and natively, replacing them with inferior / old code.

This preset complements existing V8-native functionality - it doesn't work _around_ it.

The end result is nearly always a faster build and script execution time.

Key features:

* Strict mode, to enable Classes and let (via babel-plugin-transform-strict-mode)
* Removes trailing commas from function calls (via babel-plugin-syntax-trailing-function-commas)
* CommonJS import/export module syntax (babel-plugin-transform-es2015-modules-commonjs)
* Destructuring (via babel-plugin-transform-es2015-destructuring)
* Default and rest parameters (via babel-plugin-transform-es2015-parameters)
* Sticky RegEx (via babel-plugin-transform-es2015-sticky-regex)
* Unicode RegEx (via babel-plugin-transform-es2015-unicode-regex)
* Async/await (via babel-plugin-transform-async-to-generator and babel-plugin-syntax-async-functions)

Note: This package originally shipped with the React preset, but to avoid bloat, doesn't any longer. If you want to add that, please install babel-preset-react too

Usage instructions

Installation

Install via NPM the usual way:

npm i babel-preset-node5

Usage

$3

Create a .babelrc file in your project root, and include 'node5' in your preset path:

``js
{
"presets": [
"node5"
]
}
`

Now whenever you run babel-node, it will polyfill your app with the ES2015 features that Node 5 is missing.

$3


$ babel script.js --presets node5

$3

If you don't want to use a project-wide .babelrc file (as above):

`js
require("babel-core").transform("code", {
presets: ["node5"]
});
`

And if you _do_, and you want to use vanilla node instead of babel-node as your CLI, you can create an entry script that references your pre-transpiled code like so:

`js
require('babel-register');
require('path/to/es6/script');
`

... which will then run everywhere Node can.

Of course, make sure to npm i -S babel-core or npm i -S babel-register respectively, to grab the NPM packages you'll need to transpile on-the-fly.

$3

Follow vendor instructions and include node5 in your babel "preset" list.

How to add React support

Babel has a ready-made preset for React, and you now need to install it separately.

Just grab it via NPM:

npm i babel-preset-react

And then add it to your "presets" list in .babelrc:

`js
{
"presets": [
"node5",
"react"
]
}
`

How to use async/await

The async/await proposal allows you to wait on a Promise, and write asynchronous code that looks synchronous.

Here's an example:

`js
async function getUsers(howMany) {
try {
const response = await fetch(http://jsonplaceholder.typicode.com/users/${howMany}); // <-- a Promise
return response.json(); // <-- Another promise.
} catch(e) {
console.log('some kind of error occurred: ', e)
}
}

getUsers.then(body => {
// "body" contains the result of response.json(). Async functions always
// return a promise, even if that means wrapping a non-Promise in Promise.resolve
})
`

In the above example, fetch returns a promise. By prefixing the function with async and prefixing every Promise with await, we avoid the typical .then() chain inside of the function block and can reason about the flow of the application a little more clearly.

We can also wrap promises in try/catch blocks, instead of bolting on .catch() chains.

The necessary babel plug-ins to use async/await are included in this package, so you can use this syntax right away.

No longer tracking Babel 6 versions

This package originally tracked Babel 6.x versioning. The problem is, many of the plug-ins and transforms provided by Babel don't always track the the babel-core` version, so updating one dependency can throw the versioning schema off.

This package will instead now follow its own semver, starting (arbitrarily) at v10.0.0.

I'm using this repo in production, so you can be assured that I'm making it a priority to update Babel 6 deps regularly and track the latest plug-in versions.