Compile JavaScript into CoffeeScript.
This 2.0 release is a complete rewrite featuring a better parser (Esprima). See what's new in 2.0 for an overview of new features and consult the migration guide for info on updating from 0.x.
Install
Available on npm and bower.
npm install --global js2coffeejs2coffee --help
Also available via CDN (window.js2coffee
):
https://cdn.rawgit.com/js2coffee/js2coffee/v2.1.0/dist/js2coffee.js
Command line
The command line utility accepts both filenames or stdin.
$ js2coffee file.js [file2.js ...]$ cat file.js | js2coffee
JavaScript API
Available via npm (require('js2coffee')
), or via CDN in the browser (as window.js2coffee
):
result = js2coffee; resultcode // code stringresultast // transformed ASTresultmap // source mapresultwarnings // array of warnings
Errors are in this format:
catch e emessage // "index.js:3:1: Unexpected INDENT\n\n 3 var\n ---^" edescription // "Unexpected INDENT" estart // { line: 1, column: 4 } eend // { line: 1, column: 10 } esourcePreview // '...'
Warnings are in this format:
resultwarnings
Docs
-
Migration guide - guide for migrating from 0.x.
-
Hacking guide - want to contribute? here are tips to get you started.
-
AST format - technical description of the CoffeeScript AST format.
-
Special cases - a list of edge cases that js2coffee accounts for.
-
Compatibility mode - list of tweaks that compatibility mode (
--compat
) addresses. -
Goals - outline of the project's goals.
-
Specs - examples of how JavaScript compiles to CoffeeScript.
Thanks
js2coffee © 2012+, Rico Sta. Cruz. Released under the MIT License.
Authored by Rico Sta. Cruz with help from co-maintainers and contributors (list).
Maintainers:
-
Rico Sta. Cruz (@rstacruz) — ricostacruz.com · twitter @rstacruz
-
Anton Wilhelm (@timaschew) — twitter @timaschew
-
Benjamin Lupton (@balupton) — balupton.com · twitter @balupton