Node.js 调试器

调试器

稳定性: 3 - 稳定

V8提供了强大的调试工具，可以通过TCP protocol从外部访问。Node内置这个调试工具客户端。使用这个调试器的方法是，以debug参数启动Node.js，将会出现提示，指示调试器成功启动：

% node debug myscript.js
< debugger listening on port 5858
connecting... ok
break in /home/indutny/Code/git/indutny/myscript.js:1
  1 x = 5;
  2 setTimeout(function () {
  3   debugger;
debug>

Node的调试器不支持所有的命令，但是简单的步进和检查还是可以的。在代码里嵌入debugger;，可以设置断点。

例：myscript.js代码如下：

// myscript.js
x = 5;
setTimeout(function () {
  debugger;
  console.log("world"
}, 1000
console.log("hello"

如果启动debugger，它会断在第四行：

% node debug myscript.js
< debugger listening on port 5858
connecting... ok
break in /home/indutny/Code/git/indutny/myscript.js:1
  1 x = 5;
  2 setTimeout(function () {
  3   debugger;
debug> cont
< hello
break in /home/indutny/Code/git/indutny/myscript.js:3
  1 x = 5;
  2 setTimeout(function () {
  3   debugger;
  4   console.log("world"
  5 }, 1000
debug> next
break in /home/indutny/Code/git/indutny/myscript.js:4
  2 setTimeout(function () {
  3   debugger;
  4   console.log("world"
  5 }, 1000
  6 console.log("hello"
debug> repl
Press Ctrl + C to leave debug repl
> x
5
> 2+2
4
debug> next
< world
break in /home/indutny/Code/git/indutny/myscript.js:5
  3   debugger;
  4   console.log("world"
  5 }, 1000
  6 console.log("hello"
  7
debug> quit
%

repl命令能执行远程代码；next能步进到下一行。此外可以输入help查看哪些命令可用。

监视器-Watchers

调试的时候可以查看表达式和变量。每个断点处，监视器都会显示上下文。

输入watch("my_expression")开始监视表达式，watchers显示活跃的监视器。输入unwatch("my_expression")可以移除监视器。

命令参考-Commands reference

步进-Stepping

cont, c- 继续执行

断点Breakpoints

setBreakpoint(), sb()- 当前行设置断点

也可以在尚未加载的文件里设置断点：

% ./node debug test/fixtures/break-in-module/main.js
< debugger listening on port 5858
connecting to port 5858... ok
break in test/fixtures/break-in-module/main.js:1
  1 var mod = require('./mod.js'
  2 mod.hello(
  3 mod.hello(
debug> setBreakpoint('mod.js', 23)
Warning: script 'mod.js' was not loaded yet.
  1 var mod = require('./mod.js'
  2 mod.hello(
  3 mod.hello(
debug> c
break in test/fixtures/break-in-module/mod.js:23
 21
 22 exports.hello = function() {
 23   return 'hello from module';
 24 };
 25
debug>

信息Info

backtrace, bt- 打印当前执行框架的backtrace

执行控制Execution control

run- 运行脚本 (开始调试的时候自动运行)

杂项Various

scripts- 列出所有已经加载的脚本

高级应用Advanced Usage

V8调试器可以用两种方法启用和访问，--debug命令启动调试，或向已经启动Node发送SIGUSR1。

一旦一个进程进入调试模式，它可以被node调试器连接。调试器可以通过pid或URI来连接。

node debug -p <pid>- 通过pid连接进程