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