RubyMine 2017.2 Help

Debugging CoffeeScript

Introduction

CoffeeScript code is not processed by browsers that work with JavaScript code. Therefore to be executed, CoffeeScript code has to be translated into JavaScript. This operation is referred to as compilation and the tools that perform it are called compilers.

To debug CoffeeScript in RubyMine, you need source maps generated in addition to the JavaScript code. Source maps set correspondence between lines in your CoffeeScript code and in the generated JavaScript code, otherwise your breakpoints will not be recognised and processed correctly. JavaScript and source maps are generated by compiling the CoffeeScript code manually using the File Watcher of the type CoffeeScript. After that you can debug the output JavaScript code as if it were a Node.js application.

For more details about compilation in RubyMine, see the section File Watchers.

Debugging CoffeeScript is supported only in the local mode. This means that RubyMine itself starts the Node.js engine and the target application according to a run configuration and gets full control over the session.

For more details about debugging Node.js applications, see Running and Debugging Node.js.

Debugging

To debug a CoffeeScript code, follow these general steps:

  1. Set the breakpoints in the CoffeeScript code, where necessary.
  2. Compile the CoffeeScript code into Javascript using the File Watcher of the type CoffeeScript Source Map.
  3. Start creating a Node.js run configuration with the following mandatory settings:
    1. The Node.js engine to use. By default, the field shows the path to the interpreter specified on the Node.js page during Node.js configuration.
    2. In the Working directory field, specify the location of the files referenced from the starting CoffeeScript file to run, for example, includes. If this file does not reference any other files, just leave the field empty.
    3. In the Path to Node App JS File text box, specify the full path to the JavaScript file that was generated from the original CoffeeScript file during the compilation.
  4. Save the configuration and click debug.png on the toolbar.
  5. Proceed as while debugging a Node.js application locally.
Last modified: 26 October 2017

See Also