es6now
v0.8.14
Published
ES6 to ES5 translator and ES6 runtime
Downloads
49
Readme
Overview
es6now is an ES6 to ES5 compiler, written in ES6. It will allow you to write programs using next-generation Javascript features without having to wait for Node or browsers to fully implement ES6.
es6now can also be used as a runtime environment for executing ES6 programs on top of Node.
Source maps are not required when debugging code translated with es6now. One of the fundamental design goals is that the output should look like the input. Line numbers, whitespace and comments are all maintained.
For more information:
- The Feature Guide describes the ES6 features that you can use with es6now.
- The Module Guide describes the ES6 module system implemented in es6now.
Instructions
Install globally with NPM (you may need to sudo
this):
npm install -g es6now
Start a REPL by running it without any arguments:
es6now
Execute a module by adding a path:
es6now main.js
Translate a module by using a hyphen:
es6now - src/main.js build/es6now.js -b -r
--input, -i (1) The file to translate.
--output, -o (2) The file to write to. If not set, then the output
will be written to the console.
--bundle, -b If present, module dependencies will be bundled
together in the output.
--runtime, -r If present, the es6now runtime code will be bundled
with the output.
--global, -g If specified, the name of the global variable to
dump this module's exports into, if the resulting
script is not executed within any module system.
API
es6now can also be used as a library. First, install locally with NPM:
npm install es6now
translate(input, options = {})
Translates ES6 code to ES5. The following options are defined:
- module: (Boolean) If
true
, parse the input as a module. Otherwise, parse the input as a script. The default isfalse
. - runtime: (Boolean) If
true
, include the es6now runtime library in the output. The default isfalse
. - wrap: (Boolean) If
true
, wrap the output in boilerplate which will ensure compatibility with Node and AMD modules. The default isfalse
. - global: (String) If specified, the name of the global variable which will be used to expose the module if it is loaded as a plain script in the browser.
Example:
var es6now = require("es6now");
var output = es6now.translate("class C { foo() {} }", {
module: true,
wrap: true
});