esnext

esnext

Use tomorrow's JavaScript syntax today.

NOTE: This project is early alpha. Use it in production at your own risk. For a more robust project with similar goals, see Google's Traceur.

Install

$ npm install [--save-dev] esnext

Goals

• Allow using future JavaScript syntax today.
• Require as little runtime code as possible.
• Generate human-readable code.
• TODO: Integrate with build tools such as broccoli.

Non-Goals

• Provide polyfills for future JavaScript APIs.
• Line-by-line equivalence from source to compiled.

Features

Available

• classes (via es6-class)
• generators (via regenerator)
• arrow functions (via es6-arrow-function)
• template strings (via es6-templates)
• rest params (via es6-rest-params)
• default params (via es6-default-params)
• spread (via es6-spread)

TODO

• modules (i.e. integration with es6-module-transpiler)
• block scoping (let)
• destructuring

Any omissions here are not intentional and we'd love to integrate support for more future JavaScript syntax (see es6features for a more complete list). See the Contributing section below. Keep in mind that, as of right now, this project is intended to support new JavaScript syntax only. Any new APIs should be handled using polyfills. This may change in the future.

Usage

var compile = require('esnext').compile;
var result = compile(es6Source);
fs.writeFileSync('result.js', result.code, 'utf8');
fs.writeFileSync('result.js.map', JSON.stringify(result.map), 'utf8');

Contributing

Setup

First, install the development dependencies:

$ npm install

Then, try running the tests:

$ npm test

Pull Requests

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Any contributors to the master esnext repository must sign the Individual Contributor License Agreement (CLA). It's a short form that covers our bases and makes sure you're eligible to contribute.

When you have a change you'd like to see in the master repository, send a pull request. Before we merge your request, we'll make sure you're in the list of people who have signed a CLA.

Acknowledgements

Huge thanks to Ben Newman for recast and regenerator. Thanks also to Thomas Boyt for his work on the es6-module-transpiler, es6-class, es6-arrow-function, and others.