$ npm install -g decaffeinate $ decaffeinate input.coffee input.coffee → input.js
Alternatively, paste code into the online repl to immediately see the output.
For real-world use cases, you'll likely want to spend some time understanding the different options and nuances of the decaffeinate tool. You'll also likely want to run decaffeinate using the bulk-decaffeinate wrapper tool, or write your own wrapper script. See the Conversion Guide for more information and advice on running decaffeinate on real-world code.
Complete. The project is stable enough for production use, and has been used to convert tens of thousands of lines of production code. The conversion process has been extensively tested and there are few or no known correctness bugs, although no guarantees are made.
Here are some popular open source CoffeeScript projects and their current status when run through decaffeinate. Each project has a decaffeinate-specific fork that is re-created from the original repo once per day.
|Project||Lines of CoffeeScript||Conversion status||Test status|
To contribute to this list, send a pull request to the decaffeinate-examples project.
In addition, decaffeinate has been used on private codebases within various companies, such as Square, Benchling, and Bugsnag. See this blog post from Bugsnag to read about their experiences using decaffeinate.
If you run into crashes or correctness issues, or you have suggestions on how decaffeinate could be improved, feel free to file an issue on the issues page.
--literate: Treat the input file as Literate CoffeeScript.
--keep-commonjs: Do not convert
--force-default-export: When converting to
export, use a single
export defaultrather than trying to generate named imports where possible.
--safe-import-function-identifiers: Comma-separated list of function names that may safely be in the
requiresection of the file. All other function calls will disqualify later
requires from being converted to
constwhen possible in output code.
--loose-default-params: Convert CS default params to JS default params.
--loose-for-expressions: Do not wrap expression loop targets in
--loose-for-of: Do not wrap JS
for...ofloop targets in
--loose-includes: Do not wrap in
--loose-comparison-negation: Allow unsafe simplifications like
!(a > b)to
a <= b.
--allow-invalid-constructors: Don't error when constructors use
thisbefore super or omit the
supercall in a subclass.
--enable-babel-constructor-workaround: Use a hacky Babel-specific workaround to allow
superin constructors. Also works when using TypeScript.
For more usage details, see the output of