Use tomorrow's JavaScript syntax today. Try it now in your browser.
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.
$ npm install [--save-dev] esnext
- Allow using future JavaScript syntax today.
- Require as little runtime code as possible.
- Generate human-readable code.
- Provide polyfills for future JavaScript APIs.
- Line-by-line equivalence from source to compiled.
- 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)
- comprehensions (via es6-comprehensions)
- destructuring (via es6-destructuring)
- modules (i.e. integration with es6-module-transpiler)
- block scoping (
let
)
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.
esnext ships with a command-line interface that can be used when installed
globally (or from within your project at node_modules/.bin/esnext
when
installed locally). Here's how to compile a single file an print it to stdout:
$ esnext myfile.js
If you don't care about a certain feature, such as arrow functions, you can omit support for them like so:
$ esnext --no-arrow-function myfile.js
To compile many files at once, specify an output directory:
$ esnext -o build lib/**/*.js
To enable source maps for these files, add the --source-maps
flag.
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');
Or, use one of these libraries that integrate esnext with other tools:
First, install the development dependencies:
$ npm install
Then, try running the tests:
$ npm test
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - 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.
Huge thanks to Ben Newman for recast and regenerator. Thanks to Ariya Hidayat for esprima. Thanks also to Thomas Boyt for his work on the es6-module-transpiler, es6-class, es6-arrow-function, and others.