2016-11-10 20:25:26 +00:00
|
|
|
## Class: Debugger
|
|
|
|
|
|
|
|
> An alternate transport for Chrome's remote debugging protocol.
|
|
|
|
|
2016-11-23 19:20:56 +00:00
|
|
|
Process: [Main](../glossary.md#main-process)
|
2016-11-10 20:25:26 +00:00
|
|
|
|
|
|
|
Chrome Developer Tools has a [special binding][rdp] available at JavaScript
|
|
|
|
runtime that allows interacting with pages and instrumenting them.
|
|
|
|
|
|
|
|
```javascript
|
2018-09-13 16:10:51 +00:00
|
|
|
const { BrowserWindow } = require('electron')
|
2016-11-10 20:25:26 +00:00
|
|
|
let win = new BrowserWindow()
|
|
|
|
|
|
|
|
try {
|
|
|
|
win.webContents.debugger.attach('1.1')
|
|
|
|
} catch (err) {
|
|
|
|
console.log('Debugger attach failed : ', err)
|
|
|
|
}
|
|
|
|
|
|
|
|
win.webContents.debugger.on('detach', (event, reason) => {
|
|
|
|
console.log('Debugger detached due to : ', reason)
|
|
|
|
})
|
|
|
|
|
|
|
|
win.webContents.debugger.on('message', (event, method, params) => {
|
|
|
|
if (method === 'Network.requestWillBeSent') {
|
|
|
|
if (params.request.url === 'https://www.github.com') {
|
|
|
|
win.webContents.debugger.detach()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
})
|
|
|
|
|
|
|
|
win.webContents.debugger.sendCommand('Network.enable')
|
|
|
|
```
|
|
|
|
|
|
|
|
### Instance Methods
|
|
|
|
|
|
|
|
#### `debugger.attach([protocolVersion])`
|
|
|
|
|
|
|
|
* `protocolVersion` String (optional) - Requested debugging protocol version.
|
|
|
|
|
|
|
|
Attaches the debugger to the `webContents`.
|
|
|
|
|
|
|
|
#### `debugger.isAttached()`
|
|
|
|
|
|
|
|
Returns `Boolean` - Whether a debugger is attached to the `webContents`.
|
|
|
|
|
|
|
|
#### `debugger.detach()`
|
|
|
|
|
|
|
|
Detaches the debugger from the `webContents`.
|
|
|
|
|
|
|
|
#### `debugger.sendCommand(method[, commandParams, callback])`
|
|
|
|
|
|
|
|
* `method` String - Method name, should be one of the methods defined by the
|
2018-11-06 00:53:18 +00:00
|
|
|
[remote debugging protocol][rdp].
|
2016-11-10 20:25:26 +00:00
|
|
|
* `commandParams` Object (optional) - JSON object with request parameters.
|
|
|
|
* `callback` Function (optional) - Response
|
|
|
|
* `error` Object - Error message indicating the failure of the command.
|
|
|
|
* `result` Any - Response defined by the 'returns' attribute of
|
|
|
|
the command description in the remote debugging protocol.
|
|
|
|
|
|
|
|
Send given command to the debugging target.
|
|
|
|
|
2019-03-19 17:31:45 +00:00
|
|
|
**[Deprecated Soon](modernization/promisification.md)**
|
2019-02-13 17:23:53 +00:00
|
|
|
|
|
|
|
#### `debugger.sendCommand(method[, commandParams])`
|
|
|
|
|
|
|
|
* `method` String - Method name, should be one of the methods defined by the
|
|
|
|
[remote debugging protocol][rdp].
|
|
|
|
* `commandParams` Object (optional) - JSON object with request parameters.
|
|
|
|
|
|
|
|
Returns `Promise<any>` - A promise that resolves with the response defined by
|
|
|
|
the 'returns' attribute of the command description in the remote debugging protocol
|
|
|
|
or is rejected indicating the failure of the command.
|
|
|
|
|
|
|
|
Send given command to the debugging target.
|
|
|
|
|
2016-11-10 20:25:26 +00:00
|
|
|
### Instance Events
|
|
|
|
|
|
|
|
#### Event: 'detach'
|
|
|
|
|
|
|
|
* `event` Event
|
|
|
|
* `reason` String - Reason for detaching debugger.
|
|
|
|
|
|
|
|
Emitted when debugging session is terminated. This happens either when
|
|
|
|
`webContents` is closed or devtools is invoked for the attached `webContents`.
|
|
|
|
|
|
|
|
#### Event: 'message'
|
|
|
|
|
|
|
|
* `event` Event
|
|
|
|
* `method` String - Method name.
|
|
|
|
* `params` Object - Event parameters defined by the 'parameters'
|
|
|
|
attribute in the remote debugging protocol.
|
|
|
|
|
|
|
|
Emitted whenever debugging target issues instrumentation event.
|
|
|
|
|
2018-11-06 00:53:18 +00:00
|
|
|
[rdp]: https://chromedevtools.github.io/devtools-protocol/
|
2016-11-10 20:25:26 +00:00
|
|
|
[`webContents.findInPage`]: web-contents.md#contentsfindinpagetext-options
|