RubyMine
 
2022.2
Shortcuts: Windows
Get RubyMine
You are viewing the documentation for an earlier version of RubyMine.
  1. Languages
  2. JavaScript
  3. Debug JavaScript in Chrome
  4. Configuring JavaScript debugger

Configuring JavaScript debugger

Last modified: 09 August 2022

Required plugins: Javascript and TypeScript, JavaScript Debugger

The plugins are bundled with RubyMine and enabled by default.

note

Debugging of JavaScript code is only supported in Google Chrome and in other Chromium-based browsers.

RubyMine provides a built-in debugger for your client-side JavaScript code. The built-in debugger starts automatically when you launch a debugging session.

To ensure successful debugging, it is enough to specify the built-in web server port and accept the default settings that RubyMine suggests for other debugger options.

Before you start

  1. Make sure the JavaScript and TypeScript bundled plugin is enabled on the Settings/Preferences | Plugins page, tab Installed. See Managing plugins for details.

  2. Make sure the JavaScript Debugger bundled plugin is enabled on the Settings/Preferences | Plugins page, tab Installed. See Managing plugins for details.

Bundled plugins: JavaScript and TypeScript, JavaScript Debugger

Set the built-in web server port

  1. Press Ctrl+Alt+S to open the IDE settings and select Build, Execution, Deployment | Debugger.

  2. In the Built-in server area, specify the port where the built-in web server runs. By default this port is set to the default RubyMine port 63342 through which RubyMine accepts connections from services. You can set the port number to any other value starting from 1024.

    Built-in server port

Optionally

  • Suppress calls to the files on the built-in server from other computers or from outside RubyMine by clearing the Can accept external connections or Allow unsigned requests checkbox respectively.

  • Choose the way to remove breakpoints, the default setting is Click.

    Remove breakpoints

  • On the Debugger. Data Views page under the Debugger node, configure advanced debugger options: enable or disable Inline Debugging, specify when you want to see tooltips with object values and expressions evaluation results, and so on.

    JavaScript debugger: Data views

Starting a debugging session with your default Chrome user data

You may notice that your debugging session starts in a new window with a custom Chrome user data instead of your default one. As a result, the window looks unusual, for example, your bookmarks, the browser history, and the extensions are missing, which altogether breaks your development experience. That happens because RubyMine uses Chrome Debugging Protocol and runs Chrome with the --remote-debugging-port option. However, if Chrome is already started, a debugging port can't be opened for any new or existing Chrome instance that has the same user data. Therefore, when Chrome Debugging Protocol is used, RubyMine always starts a debugging session with in a new window with a custom user data.

To open a new Chrome instance with your familiar look-and-feel, configure Chrome in RubyMine to start with your user data. In this case, before starting a debugging session, always make sure that Chrome is not already running with your user data. Otherwise, RubyMine still launches another instance of Chrome with your user data but is unable to open a debugging port for it. As a result, RubyMine debugger fails to connect to the application in the new Chrome instance and the debugging session does not start.

https://resources.jetbrains.com/help/img/idea/2022.2/js_debugger_custom_chrome_user_data.png
Gif

Configure Chrome in RubyMine to start with your Chrome user data

  1. Save your Chrome user data anywhere on your machine.

  2. Press Ctrl+Alt+S to open the IDE settings and select Tools | Web Browsers and Preview.

  3. To create a new Chrome configuration, click Add. A new item appears in the list. In the Path field, specify the path to the Chrome installation folder.

  4. Select the new configuration and click Edit. The Chrome Settings dialog opens.

  5. Select the Use custom user data directory checkbox and specify the path to your user data directory in the RubyMine settings.

  6. Mark your Chrome browser configuration default as described in Web Browsers, and don't forget to choose Default from the Browser list when creating a run/debug configuration.

    tip

    Alternatively, always choose this Chrome browser configuration from the Browser list.

See also

Procedures