Node.js v25.0.0 文件

單步執行#

• cont, c: 繼續執行
• next, n: 單步跳過
• step, s: 單步進入
• out, o: 單步跳出
• pause: 暫停正在執行的程式碼（類似於開發者工具中的暫停按鈕）

斷點#

• setBreakpoint(), sb(): 在當前行設定斷點
• setBreakpoint(line), sb(line): 在指定行設定斷點
• setBreakpoint('fn()'), sb(...): 在函式體的第一條語句上設定斷點
• setBreakpoint('script.js', 1), sb(...): 在 script.js 的第一行設定斷點
• setBreakpoint('script.js', 1, 'num < 4'), sb(...): 在 script.js 的第一行設定一個條件斷點，僅當 num < 4 的計算結果為 true 時中斷
• clearBreakpoint('script.js', 1), cb(...): 清除 script.js 檔案第 1 行的斷點

也可以在一個尚未載入的檔案（模組）中設定斷點。

$ node inspect main.js
< Debugger listening on ws://127.0.0.1:9229/48a5b28a-550c-471b-b5e1-d13dd7165df9
< For help, see: https://nodejs.com.tw/en/docs/inspector
<
connecting to 127.0.0.1:9229 ... ok
< Debugger attached.
<
Break on start in main.js:1
> 1 const mod = require('./mod.js');
  2 mod.hello();
  3 mod.hello();
debug> setBreakpoint('mod.js', 22)
Warning: script 'mod.js' was not loaded yet.
debug> c
break in mod.js:22
 20 // USE OR OTHER DEALINGS IN THE SOFTWARE.
 21
>22 exports.hello = function() {
 23   return 'hello from module';
 24 };
debug> copy

也可以設定一個條件斷點，僅當給定表示式的計算結果為 true 時才中斷。

$ node inspect main.js
< Debugger listening on ws://127.0.0.1:9229/ce24daa8-3816-44d4-b8ab-8273c8a66d35
< For help, see: https://nodejs.com.tw/en/docs/inspector
<
connecting to 127.0.0.1:9229 ... ok
< Debugger attached.
Break on start in main.js:7
  5 }
  6
> 7 addOne(10);
  8 addOne(-1);
  9
debug> setBreakpoint('main.js', 4, 'num < 0')
  1 'use strict';
  2
  3 function addOne(num) {
> 4   return num + 1;
  5 }
  6
  7 addOne(10);
  8 addOne(-1);
  9
debug> cont
break in main.js:4
  2
  3 function addOne(num) {
> 4   return num + 1;
  5 }
  6
debug> exec('num')
-1
debug> copy

資訊#

• backtrace, bt: 列印當前執行幀的回溯跟蹤
• list(5): 列出指令碼原始碼及 5 行上下文（前後各 5 行）
• watch(expr): 將表示式新增到監視列表
• unwatch(expr): 從監視列表中移除表示式
• unwatch(index): 從監視列表中移除指定索引的表示式
• watchers: 列出所有監視器及其值（在每個斷點處自動列出）
• repl: 開啟偵錯程式的 repl，以便在除錯指令碼的上下文中進行評估
• exec expr, p expr: 在除錯指令碼的上下文中執行一個表示式並列印其值
• profile: 啟動 CPU 分析會話
• profileEnd: 停止當前的 CPU 分析會話
• profiles: 列出所有已完成的 CPU 分析會話
• profiles[n].save(filepath = 'node.cpuprofile'): 將 CPU 分析會話以 JSON 格式儲存到磁碟
• takeHeapSnapshot(filepath = 'node.heapsnapshot'): 獲取堆快照並以 JSON 格式儲存到磁碟

執行控制#

• run: 執行指令碼（在偵錯程式啟動時自動執行）
• restart: 重啟指令碼
• kill: 終止指令碼

其他#

• scripts: 列出所有已載入的指令碼
• version: 顯示 V8 的版本

Node.js 的 V8 檢查器整合#

V8 檢查器整合允許將 Chrome 開發者工具附加到 Node.js 例項上進行除錯和效能分析。它使用了 Chrome 開發者工具協議。

V8 檢查器可以透過在啟動 Node.js 應用程式時傳遞 --inspect 標誌來啟用。也可以透過該標誌提供一個自定義埠，例如 --inspect=9222 將在 9222 埠上接受開發者工具的連線。

使用 --inspect 標誌會在偵錯程式連線之前立即執行程式碼。這意味著在你開始除錯之前程式碼就已經開始執行，如果你想從最開始進行除錯，這可能並不理想。

在這種情況下，你有兩個替代方案：

1. --inspect-wait 標誌：此標誌會在執行程式碼前等待偵錯程式連線。這使你可以從執行的一開始就進行除錯。
2. --inspect-brk 標誌：與 --inspect 不同，此標誌會在偵錯程式連線後立即在程式碼的第一行中斷。當你想從最開始一步步除錯程式碼，並且不希望在除錯前有任何程式碼執行時，這非常有用。

因此，在決定使用 --inspect、--inspect-wait 還是 --inspect-brk 時，請考慮你是希望程式碼立即開始執行，還是等待偵錯程式連線後再執行，或者是在第一行中斷以便進行逐步除錯。

$ node --inspect index.js
Debugger listening on ws://127.0.0.1:9229/dc9010dd-f8b8-4ac5-a510-c1a114ec7d29
For help, see: https://nodejs.com.tw/en/docs/inspector copy

（在上面的示例中，URL 末尾的 UUID dc9010dd-f8b8-4ac5-a510-c1a114ec7d29 是動態生成的，在不同的除錯會話中會有所不同。）

如果 Chrome 瀏覽器版本低於 66.0.3345.0，請在上述 URL 中使用 inspector.html 而不是 js_app.html。

Chrome 開發者工具尚不支援除錯 工作執行緒。可以使用 ndb 來除錯它們。