调试

TIP

调试测试时，你可能需要使用 --test-timeout 命令行参数，以防止在断点处暂停时测试超时。

VSCode

在 VSCode 中快速调试测试的方法是使用 JavaScript Debug Terminal。打开一个新的 JavaScript Debug Terminal 并直接运行 npm run test 或 vitest。这适用于任何在 Node.js 中运行的代码，因此也适用于大多数 JavaScript 测试框架。

你还可以添加专门的启动配置来调试测试文件：

json

{
  // 有关更多信息，请访问：https://go.microsoft.com/fwlink/?linkid=830387
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Current Test File",
      "autoAttachChildProcesses": true,
      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
      "args": ["run", "${relativeFile}"],
      "smartStep": true,
      "console": "integratedTerminal"
    }
  ]
}

然后在调试选项卡中，确保选中“Debug Current Test File”。打开要调试的测试文件，并按 F5 开始调试。

IntelliJ IDEA

创建一个“Node.js”运行配置。使用以下设置以调试模式运行所有测试：

设置	值
工作目录	`/path/to/your-project-root`
JavaScript 文件	`./node_modules/vitest/vitest.mjs`
应用程序参数	`run --pool forks`

然后在调试模式下运行此配置。IDE 将会在编辑器中设置的 JavaScript/TypeScript 断点处暂停。

Node Inspector，例如 Chrome DevTools

Vitest 也支持不依赖 IDE 调试测试。但这要求测试不能并行运行。使用以下命令之一来启动 Vitest。

# 以单 worker 运行
vitest --inspect-brk --pool threads --poolOptions.threads.singleThread

# 以单个子进程运行
vitest --inspect-brk --pool forks --poolOptions.forks.singleFork

如果您使用的是 Vitest 1.1 或更高版本，您也可以直接提供 --no-file-parallelism 标志:

# 如果 pool 未知
vitest --inspect-brk --no-file-parallelism

一旦 Vitest 启动，它将停止执行并等待您打开可以连接到 Node.js 检查器的开发者工具。您可以使用 Chrome DevTools，通过在浏览器中打开 chrome://inspect 来实现。

在监听模式下，您可以使用 --poolOptions.threads.isolate false 选项来保持调试器在测试重新运行时保持打开状态。

调试 ​

VSCode ​

IntelliJ IDEA ​

Node Inspector，例如 Chrome DevTools ​

调试

VSCode

IntelliJ IDEA

Node Inspector，例如 Chrome DevTools