Compile JavaScript into CoffeeScript.
This 2.0 release is a complete rewrite featuring a better parser (Esprima). See the migration guide for instructions on how to update from 0.x.
Available on npm and bower.
npm install --global js2coffee
js2coffee --help
Also available via CDN (window.js2coffee):
http://cdn.rawgit.com/js2coffee/js2coffee/v2.0.0/dist/js2coffee.js
The command line utility accepts both filenames or stdin.
$ js2c file.js [file2.js ...]
$ cat file.js | js2c
Available via npm (require('js2coffee')), or via CDN in the browser (as window.js2coffee):
result = js2coffee.build(source);
result.code // code string
result.ast // transformed AST
result.map // source map
result.warnings // array of warnings
Errors are in this format:
catch (e) {
e.message // "index.js:3:1: Unexpected INDENT\n\n 3 var\n ---^"
e.description // "Unexpected INDENT"
e.start // { line: 1, column: 4 }
e.end // { line: 1, column: 10 }
e.sourcePreview // '...'
}
Warnings are in this format:
result.warnings.forEach((warn) => {
warn.description // "Variable 'x' defined twice
warn.start // { line: 1, column: 4 }
warn.end // { line: 1, column: 9 }
warn.filename // "index.js"
})
Migration guide - guide for migrating from 0.x.
Goals - outline of the project's goals.
Specs - examples of how JavaScript compiles to CoffeeScript.
AST format - technical description of the CoffeeScript AST format.
Special cases - a list of edge cases that js2coffee accounts for.
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
v2.0.0
Feb 2, 2015
Full rewrite that features the Esprima parser. This release resolves a lot of issues, a lot of which are tracked with the ["fixed in 2.0"][fixed] label.
Check the migration guide for information on what's changed from v0 to v2.0.
x != undefinedfor inpackage.json file
// OPTIONS:{"single_quotes":true}Thanks to [@balupton], [@tsantef], [@ForbesLindesay]
Small "emergency" bugfixes, thanks [@tricknotes].
js2coffee. ([#113])Thanks to [@Wisdom], [@nilbus], [@joelvh], [@gabipurcaru], [@michaelficarra], [@tricknotes], [@eventualbuddha], [@clkao] for the contributions.
o[{a:1, b:2}]) are now supported.js2coffee file.js not working in Linux. ([#90], [#54])if (x) return y;)) ([#50])return {x:1, y:2}) ([#52]){ a: { b: c } }. ([#96], [#94])object.on(...). ([#97], [#95], [#75])undefined now gets compiled properly. ([#20], [#85])var x will now translate to x = undefined. ([#79])!! into !! instead of not not. ([#30])!!!x now condenses to not x.== and === now become is. ([#29])!(a instanceof b) now becomes a not instanceof b. ([#29])var x = y will now have different behavior for reserved keywords.
([#79])npm test run tests.Lots of refactoring and new improvements.
if (x) continue; will now compile to continue if x.try { .. } catch (f) {} now becomes try .. without a catch.x.prototype.y to be x::y instead of x::.y ([#24])in operator now compiles to of. ([#46])
a in b now compiles to a of b.Builder is now a class (to support warnings in the future, and more).Transformer class to do AST transformations before building the compiled source.Node::walk().js2coffee/helpers.coffee and js2coffee/node_ext.coffee.Special thanks to Michael Ficarra for agressively reporting issues and suggesting numerous improvements.
if !x?). ([#19])
if (x != null) to unless x?if (x === null) to if x?({ .. }). ([#8])debugger. ([#27])loop instead of while true in while and for loops. ([#35]):: prototype operator. ([#24])unless and until as the inverse of if and while respectively. ([#35]){ 'click #button': function() { ... } }.++b is now no longer erroneously translated to b++.{ off: 2 } erroneously becomes { off_: 2 }.js2coffee.min.js.this instead of @ for better readability. ([#10])a = 2, b = 3)switch instead of ifInitial version.
FAQs
JavaScript to CoffeeScript compiler
The npm package js2coffee receives a total of 5,111 weekly downloads. As such, js2coffee popularity was classified as popular.
We found that js2coffee demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Company News
Socket is joining TC54 to help develop standards for software supply chain security, contributing to the evolution of SBOMs, CycloneDX, and Package URL specifications.
Security News
PyPI now allows maintainers to archive projects, improving security and helping users make informed decisions about their dependencies.
Research
Security News
Malicious npm package postcss-optimizer delivers BeaverTail malware, targeting developer systems; similarities to past campaigns suggest a North Korean connection.