IO.js Debugger

穩(wěn)定度: 2 - 穩(wěn)定

V8自帶了一個強大的調(diào)試器，可以從外部通過TCP協(xié)議訪問。io.js為這個調(diào)試器內(nèi)建了一個客戶端。要使用它的話，使用debug參數(shù)啟動io.js；會出現(xiàn)提示符：

% iojs 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>

io.js的調(diào)試器客戶端并未支持所有的命令，但是簡單的步進和調(diào)試都是可以的。通過在源代碼就放置debugger;語句，你可以啟用一個斷點。

例如，假設又一個這樣的myscript.js：

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

那么一旦你打開調(diào)試器，它會在第四行中斷。

% iojs 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命令允許你遠程地執(zhí)行代碼。next命令步進到下一行。還有一些其他的可用命令，輸入help查看它們。

Watchers

在調(diào)試代碼時，你可監(jiān)視表達式和變量的值。在每個斷點，監(jiān)視器列表上的每個表達式會被在當前上下文執(zhí)行，并且斷點的源代碼前展示。

為了開始監(jiān)視一個表達式，輸入watch("my_expression")。watchers打印可用的監(jiān)視器。為了移除一個監(jiān)視器，輸入unwatch("my_expression")。

命令參考

Stepping

• cont, c - 繼續(xù)執(zhí)行
• next, n - 下一步
• step, s - 介入（Step in）
• out, o - 離開（Step out）
• pause - 暫停代碼執(zhí)行（類似開發(fā)者工具中的暫停按鈕）

Breakpoints

• setBreakpoint(), sb() - 在當前行設置一個斷點
• setBreakpoint(line), sb(line) - 在指定行設置一個斷點
• setBreakpoint('fn()'), sb(...) - 在函數(shù)體的第一個語句上設置斷點
• setBreakpoint('script.js', 1), sb(...) - 在script.js的第一行設置斷點
• clearBreakpoint('script.js', 1), cb(...) - 清除script.js第一行的斷點

同樣也可以在一個還未載入的文件（模塊）中設置斷點：

% ./iojs 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 - 打印當前執(zhí)行框架的回溯
• list(5) - 列出腳本源代碼的5行上下文（前5行和后5行）
• watch(expr) - 為監(jiān)視列表添加表達式
• unwatch(expr) - 從監(jiān)視列表中移除表達式
• watchers - 列出所有的監(jiān)視器和它們的值（會在每一個斷點自動列出）
• repl - 在所調(diào)試的腳本上下文中打開調(diào)試器的repl

Execution control

• run - 運行腳本（在調(diào)試器開始時自動運行）
• restart - 重啟腳本
• kill - 結(jié)束腳本

Various

• scripts - 列出所有載入的腳本
• version - 展示V8版本

高級使用

V8調(diào)試器可以通過 使用--debug命令行參數(shù)打開io.js 或 向一個已存在的io.js進程發(fā)送SIGUSR1信號 來啟用。

一旦一個進程被設置為了調(diào)試模式，它就可以被連接到io.js調(diào)試器?？梢酝ㄟ^pid或URI來連接，語法為：

• iojs debug -p - 通過pid連接進程
• iojs debug - 通過URI（如localhost:5858）連接進程