|
|
@ -1,4 +1,6 @@ |
|
|
## Debugger |
|
|
# Debugger |
|
|
|
|
|
|
|
|
|
|
|
<!-- type=concept --> |
|
|
|
|
|
|
|
|
V8 comes with an extensive debugger which is accessible out-of-process via a |
|
|
V8 comes with an extensive debugger which is accessible out-of-process via a |
|
|
simple [TCP protocol](http://code.google.com/p/v8/wiki/DebuggerProtocol). |
|
|
simple [TCP protocol](http://code.google.com/p/v8/wiki/DebuggerProtocol). |
|
|
@ -74,7 +76,7 @@ The `repl` command allows you to evaluate code remotely. The `next` command |
|
|
steps over to the next line. There are a few other commands available and more |
|
|
steps over to the next line. There are a few other commands available and more |
|
|
to come. Type `help` to see others. |
|
|
to come. Type `help` to see others. |
|
|
|
|
|
|
|
|
### Watchers |
|
|
## Watchers |
|
|
|
|
|
|
|
|
You can watch expression and variable values while debugging your code. |
|
|
You can watch expression and variable values while debugging your code. |
|
|
On every breakpoint each expression from the watchers list will be evaluated |
|
|
On every breakpoint each expression from the watchers list will be evaluated |
|
|
@ -85,16 +87,16 @@ To start watching an expression, type `watch("my_expression")`. `watchers` |
|
|
prints the active watchers. To remove a watcher, type |
|
|
prints the active watchers. To remove a watcher, type |
|
|
`unwatch("my_expression")`. |
|
|
`unwatch("my_expression")`. |
|
|
|
|
|
|
|
|
### Commands reference |
|
|
## Commands reference |
|
|
|
|
|
|
|
|
#### Stepping |
|
|
### Stepping |
|
|
|
|
|
|
|
|
* `cont`, `c` - Continue execution |
|
|
* `cont`, `c` - Continue execution |
|
|
* `next`, `n` - Step next |
|
|
* `next`, `n` - Step next |
|
|
* `step`, `s` - Step in |
|
|
* `step`, `s` - Step in |
|
|
* `out`, `o` - Step out |
|
|
* `out`, `o` - Step out |
|
|
|
|
|
|
|
|
#### Breakpoints |
|
|
### Breakpoints |
|
|
|
|
|
|
|
|
* `setBreakpoint()`, `sb()` - Set breakpoint on current line |
|
|
* `setBreakpoint()`, `sb()` - Set breakpoint on current line |
|
|
* `setBreakpoint('fn()')`, `sb(...)` - Set breakpoint on a first statement in |
|
|
* `setBreakpoint('fn()')`, `sb(...)` - Set breakpoint on a first statement in |
|
|
@ -103,7 +105,7 @@ functions body |
|
|
script.js |
|
|
script.js |
|
|
* `clearBreakpoint`, `cb(...)` - Clear breakpoint |
|
|
* `clearBreakpoint`, `cb(...)` - Clear breakpoint |
|
|
|
|
|
|
|
|
#### Info |
|
|
### Info |
|
|
|
|
|
|
|
|
* `backtrace`, `bt` - Print backtrace of current execution frame |
|
|
* `backtrace`, `bt` - Print backtrace of current execution frame |
|
|
* `list(5)` - List scripts source code with 5 line context (5 lines before and |
|
|
* `list(5)` - List scripts source code with 5 line context (5 lines before and |
|
|
@ -114,21 +116,19 @@ after) |
|
|
breakpoint) |
|
|
breakpoint) |
|
|
* `repl` - Open debugger's repl for evaluation in debugging script's context |
|
|
* `repl` - Open debugger's repl for evaluation in debugging script's context |
|
|
|
|
|
|
|
|
#### Execution control |
|
|
### Execution control |
|
|
|
|
|
|
|
|
* `run` - Run script (automatically runs on debugger's start) |
|
|
* `run` - Run script (automatically runs on debugger's start) |
|
|
* `restart` - Restart script |
|
|
* `restart` - Restart script |
|
|
* `kill` - Kill script |
|
|
* `kill` - Kill script |
|
|
|
|
|
|
|
|
#### Various |
|
|
### Various |
|
|
|
|
|
|
|
|
* `scripts` - List all loaded scripts |
|
|
* `scripts` - List all loaded scripts |
|
|
* `version` - Display v8's version |
|
|
* `version` - Display v8's version |
|
|
|
|
|
|
|
|
### Advanced Usage |
|
|
## Advanced Usage |
|
|
|
|
|
|
|
|
The V8 debugger can be enabled and accessed either by starting Node with |
|
|
The V8 debugger can be enabled and accessed either by starting Node with |
|
|
the `--debug` command-line flag or by signaling an existing Node process |
|
|
the `--debug` command-line flag or by signaling an existing Node process |
|
|
with `SIGUSR1`. |
|
|
with `SIGUSR1`. |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
isaacs
13 years ago