使用VS Code调试AVA测试框架的完整指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00357/article/details/148362534

使用VS Code调试AVA测试框架的完整指南

ava Node.js test runner that lets you develop with confidence 🚀 项目地址: https://gitcode.com/gh_mirrors/ava/ava

前言

AVA是一个轻量级且高效的JavaScript测试运行器，它以并发执行测试而闻名。但在开发过程中，我们经常需要对测试代码进行调试。本文将详细介绍如何使用Visual Studio Code（VS Code）来调试AVA测试代码，帮助开发者快速定位和解决问题。

准备工作

在开始调试之前，请确保：

已安装最新版本的VS Code
项目中已配置好AVA测试框架
了解基本的测试代码结构和调试概念

方法一：使用调试终端

VS Code提供了一个便捷的"JavaScript调试终端"，可以快速启动调试会话：

打开命令面板（快捷键：F1或Cmd+Shift+P/Ctrl+Shift+P）
搜索并选择"Debug: JavaScript Debug Terminal"
在新打开的终端中输入：npx ava

这种方法简单快捷，适合快速调试整个测试套件。

方法二：创建调试配置

对于更复杂的调试场景，特别是需要调试单个测试文件时，创建专门的调试配置更为合适。

基础配置步骤

在VS Code中打开项目工作区
点击侧边栏的"调试"图标
创建或编辑launch.json文件
选择Node.js环境
添加以下配置：

{
  "type": "node",
  "request": "launch",
  "name": "Debug AVA test文件",
  "program": "${workspaceFolder}/node_modules/ava/entrypoints/cli.mjs",
  "args": ["${file}"],
  "outputCapture": "std",
  "console": "integratedTerminal",
  "skipFiles": ["<node_internals>/**/*.js"]
}

使用调试器

配置完成后：

打开要调试的测试文件
在代码中设置断点或添加debugger语句
从调试菜单中选择"Debug AVA test文件"配置
开始调试会话

高级调试场景

调试预编译测试

如果测试代码需要编译（如使用TypeScript），且从编译目录运行测试，则需要调整配置：

{
  "type": "node",
  "request": "launch",
  "name": "Debug AVA test文件",
  "program": "${workspaceFolder}/node_modules/ava/entrypoints/cli.mjs",
  "args": ["build/**/${fileBasenameNoExtension}.*"],
  "outputCapture": "std",
  "console": "integratedTerminal",
  "skipFiles": ["<node_internals>/**/*.js"]
}

使用Yarn PnP

对于使用Yarn PnP的项目，配置略有不同：

{
  "type": "node",
  "request": "launch",
  "name": "Debug AVA test文件",
  "runtimeExecutable": "yarn",
  "runtimeArgs": ["run", "ava"],
  "args": ["${file}"],
  "outputCapture": "std",
  "console": "integratedTerminal",
  "skipFiles": ["<node_internals>/**/*.js"]
}

串行调试模式

AVA默认并发执行测试，这可能给调试带来困难。建议在调试时使用串行模式：

在调试终端中：npx ava --serial
或在配置中添加--serial参数：

{
  "type": "node",
  "request": "launch",
  "name": "Debug AVA test文件",
  "program": "${workspaceFolder}/node_modules/ava/entrypoints/cli.mjs",
  "args": ["--serial", "${file}"],
  "outputCapture": "std",
  "console": "integratedTerminal",
  "skipFiles": ["<node_internals>/**/*.js"]
}