2015-08-31 20:12:57 -06:00
|
|
|
# Debugging the Main Process
|
2014-08-19 20:01:43 -06:00
|
|
|
|
2016-09-21 03:39:15 -06:00
|
|
|
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
|
2017-06-06 15:30:45 -06:00
|
|
|
launch Electron with the `--inspect` or `--inspect-brk` switch.
|
2014-08-19 20:01:43 -06:00
|
|
|
|
2015-08-31 20:12:57 -06:00
|
|
|
## Command Line Switches
|
|
|
|
|
2016-09-21 03:39:15 -06:00
|
|
|
Use one of the following command line switches to enable debugging of the main
|
|
|
|
process:
|
2014-08-19 20:43:41 -06:00
|
|
|
|
2017-05-15 10:34:55 -06:00
|
|
|
### `--inspect=[port]`
|
2014-08-19 20:01:43 -06:00
|
|
|
|
2017-05-15 10:34:55 -06:00
|
|
|
Electron will listen for V8 inspector protocol messages on the specified `port`,
|
2016-09-21 03:39:15 -06:00
|
|
|
an external debugger will need to connect on this port. The default `port` is
|
|
|
|
`5858`.
|
2014-08-19 20:01:43 -06:00
|
|
|
|
2016-10-31 10:27:42 -06:00
|
|
|
```shell
|
2017-05-15 10:34:55 -06:00
|
|
|
electron --inspect=5858 your/app
|
2016-10-28 09:04:51 -06:00
|
|
|
```
|
2016-10-31 10:27:42 -06:00
|
|
|
|
2017-05-15 10:34:55 -06:00
|
|
|
### `--inspect-brk=[port]`
|
2014-08-19 20:01:43 -06:00
|
|
|
|
2017-11-05 17:23:18 -07:00
|
|
|
Like `--inspect` but pauses execution on the first line of JavaScript.
|
2014-08-19 20:43:41 -06:00
|
|
|
|
2016-09-21 03:39:15 -06:00
|
|
|
## External Debuggers
|
2016-09-19 23:43:05 -06:00
|
|
|
|
2017-05-15 10:34:55 -06:00
|
|
|
You will need to use a debugger that supports the V8 inspector protocol.
|
2016-09-19 23:43:05 -06:00
|
|
|
|
2017-05-15 10:40:00 -06:00
|
|
|
- Connect Chrome by visiting `chrome://inspect` and selecting to inspect the
|
|
|
|
launched Electron app present there.
|
2020-11-06 17:55:55 -07:00
|
|
|
- [Debugging in VSCode](debugging-vscode.md)
|