Node.js v16.20.0 文档

监视器#

¥Watchers

可以在调试时监视表达式和变量值。在每个断点上，监视器列表中的每个表达式都将在当前上下文中进行评估，并且立即显示在断点的源代码列表之前。

¥It is possible to watch expression and variable values while debugging. On every breakpoint, each expression from the watchers list will be evaluated in the current context and displayed immediately before the breakpoint's source code listing.

要开始监视表达式，则键入 watch('my_expression')。命令 watchers 将打印活动的监视器。要删除监视器，请键入 unwatch('my_expression')。

¥To begin watching an expression, type watch('my_expression'). The command watchers will print the active watchers. To remove a watcher, type unwatch('my_expression').

命令参考资料#

¥Command reference

步进#

¥Stepping

• cont, c:继续执行

  ¥cont, c: Continue execution

• next, n:单步执行下一行

  ¥next, n: Step next

• step, s:单步进入

  ¥step, s: Step in

• out, o:单步退出

  ¥out, o: Step out

• pause：暂停正在运行的代码（类似于开发者工具中的暂停按钮）

  ¥pause: Pause running code (like pause button in Developer Tools)

断点#

¥Breakpoints

• setBreakpoint(), sb():在当前行上设置断点

  ¥setBreakpoint(), sb(): Set breakpoint on current line

• setBreakpoint(line), sb(line):在特定行上设置断点

  ¥setBreakpoint(line), sb(line): Set breakpoint on specific line

• setBreakpoint('fn()'), sb(...):在函数体的第一条语句上设置断点

  ¥setBreakpoint('fn()'), sb(...): Set breakpoint on a first statement in function's body

• setBreakpoint('script.js', 1), sb(...):在 script.js 的第一行上设置断点

  ¥setBreakpoint('script.js', 1), sb(...): Set breakpoint on first line of script.js

• setBreakpoint('script.js', 1, 'num < 4'), sb(...):在 script.js 的第一行上设置条件断点，仅当 num < 4 评估为 true 时才中断

  ¥setBreakpoint('script.js', 1, 'num < 4'), sb(...): Set conditional breakpoint on first line of script.js that only breaks when num < 4 evaluates to true

• clearBreakpoint('script.js', 1), cb(...):清除 script.js 中第 1 行上的断点

  ¥clearBreakpoint('script.js', 1), cb(...): Clear breakpoint in script.js on line 1

还可以在尚未加载的文件（模块）中设置断点：

¥It is also possible to set a breakpoint in a file (module) that is not loaded yet:

$ node inspect main.js
< Debugger listening on ws://127.0.0.1:9229/48a5b28a-550c-471b-b5e1-d13dd7165df9
< For help, see: https://nodejs.cn/docs/inspector
<
< Debugger attached.
<
 ok
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> 拷贝

也可以设置条件断点，仅当给定的表达式评估为 true 时才中断：

¥It is also possible to set a conditional breakpoint that only breaks when a given expression evaluates to true:

$ node inspect main.js
< Debugger listening on ws://127.0.0.1:9229/ce24daa8-3816-44d4-b8ab-8273c8a66d35
< For help, see: https://nodejs.cn/docs/inspector
< 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> 拷贝

信息#

¥Information

• backtrace, bt:打印当前执行帧的回溯

  ¥backtrace, bt: Print backtrace of current execution frame

• list(5)：列出脚本源代码的 5 行上下文（前后各 5 行）

  ¥list(5): List scripts source code with 5 line context (5 lines before and after)

• watch(expr)：将表达式添加到监视列表

  ¥watch(expr): Add expression to watch list

• unwatch(expr)：从监视列表中删除表达式

  ¥unwatch(expr): Remove expression from watch list

• watchers：列出所有监视器及其值（在每个断点上自动列出）

  ¥watchers: List all watchers and their values (automatically listed on each breakpoint)

• repl：打开调试器的交互式解释器，以在调试脚本的上下文中进行评估

  ¥repl: Open debugger's repl for evaluation in debugging script's context

• exec expr, p expr:在调试脚本的上下文中执行表达式并打印它的值

  ¥exec expr, p expr: Execute an expression in debugging script's context and print its value

执行控制#

¥Execution control

• run：运行脚本（在调试器启动时自动运行）

  ¥run: Run script (automatically runs on debugger's start)

• restart：重启脚本

  ¥restart: Restart script

• kill：杀死脚本

  ¥kill: Kill script

其他#

¥Various

• scripts：列出所有加载的脚本

  ¥scripts: List all loaded scripts

• version：显示 V8 的版本

  ¥version: Display V8's version

高级用法#

¥Advanced usage

Node.js 的 V8 检查器集成#

¥V8 inspector integration for Node.js

V8 检查器集成允许将 Chrome 开发者工具绑定到 Node.js 实例以进行调试和分析。它使用 Chrome DevTools 协议。

¥V8 Inspector integration allows attaching Chrome DevTools to Node.js instances for debugging and profiling. It uses the Chrome DevTools Protocol.

V8 检查器可以通过在启动 Node.js 应用时传入 --inspect 标志来启用。也可以使用该标志提供自定义的端口，例如 --inspect=9222 将接受端口 9222 上的开发者工具连接。

¥V8 Inspector can be enabled by passing the --inspect flag when starting a Node.js application. It is also possible to supply a custom port with that flag, e.g. --inspect=9222 will accept DevTools connections on port 9222.

要中断应用代码的第一行，则传入 --inspect-brk 标志而不是 --inspect。

¥To break on the first line of the application code, pass the --inspect-brk flag instead of --inspect.

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

（在上面的示例中，网址末尾的 UUID dc9010dd-f8b8-4ac5-a510-c1a114ec7d29 是动态生成的，它在不同的调试会话中有所不同。）

¥(In the example above, the UUID dc9010dd-f8b8-4ac5-a510-c1a114ec7d29 at the end of the URL is generated on the fly, it varies in different debugging sessions.)

如果 Chrome 浏览器版本低于 66.0.3345.0，则在上述网址中使用 inspector.html 而不是 js_app.html。

¥If the Chrome browser is older than 66.0.3345.0, use inspector.html instead of js_app.html in the above URL.

Chrome DevTools 尚不支持调试 工作线程。ndb 可用于调试它们。

¥Chrome DevTools doesn't support debugging worker threads yet. ndb can be used to debug them.