Running and Debugging Node.js
On this page:
- Before You Start
- Local and Remote Modes of Running or Debugging Node.js Applications
- Running a Node.js Application
- Debugging a Node.js Application Locally
Before You Start
Install and enable the NodeJS plugin. The plugin is not bundled with AppCode, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.
Local and Remote Modes of Running or Debugging Node.js Applications
Running a Node.js application in AppCode is supported only in the local mode. This means that AppCode itself starts the Node.js engine and the target application according to a run configuration and gets full control over the session.
- Locally, with the Node.js engine started from AppCode.
- Remotely, when AppCode connects to an already running Node.js application. This approach gives you the possibility to re-start a debugging session without re-starting the Node.js server.
You can also
configure the behaviour of the browser and enable debugging the client-side code of the application. This functionality is provided through a
technically, AppCode creates separate run configurations for the server-side and the client-side code,
but you specify all your settings in one dedicated NodeJS run configuration.
Running a Node.js Application
- Create a Node.js run configuration.
- To launch the application, select the run configuration from the list on the main tool bar and then choose on the main menu or click the Run toolbar button . The Run tool window opens.
Open the browser of your choice and open the page with the URL address generated through the
based on the
hostparameters. The page shows the result of executing your Node.js application.
Debugging a Node.js Application Locally
- Set the breakpoints in the Node.js code, where necessary. At least one breakpoint is necessary otherwise the program will be just executed. If you want the debugging tool to stop at the first line of your code, set a breakpoint at the first line.
- Create a Node.js run/debug configuration.
- To start a debugging session, select the required debug configuration from the list on the main tool bar and then choose on the main menu or click the Debug toolbar button .
- Open the browser of your choice and open the starting page of your application. Control over the debugging session returns to AppCode.
- Switch to AppCode, where the controls of the Debug tool window are now enabled. Proceed with the debugging session step through the breakpoints, switch between frames, change values on-the-fly, examine a suspended program, evaluate expressions, and set watches.