Electron Documentation1.6.2

Docs / Tutorial / Debugging the Main Process

Debugging the Main Process

The DevTools in an Electron browser window can only debug JavaScript that’s executed in that window (i.e. the web pages). To debug JavaScript that’s executed in the main process you will need to use an external debugger and launch Electron with the --debug or --debug-brk switch.

Command Line Switches

Use one of the following command line switches to enable debugging of the main process:

--debug=[port]

Electron will listen for V8 debugger protocol messages on the specified port, an external debugger will need to connect on this port. The default port is 5858.

electron --debug=5858 your/app

--debug-brk=[port]

Like --debug but pauses execution on the first line of JavaScript.

External Debuggers

You will need to use a debugger that supports the V8 debugger protocol, the following guides should help you to get started:


See something that needs fixing? Propose a change on the source.
Need a different version of the docs? See the available versions or community translations.
Want to search all the documentation at once? See all of the docs on one page.