基于Appium+Webdriver.io+Mocha的断点调试方案问询

针对你的需求，以下几种本地调试方案完全可以实现断点暂停、变量查看、逐步执行的功能，比单纯打印日志高效得多：

1. VS Code 集成调试（最优IDE方案） #

利用VS Code的Node.js调试能力，配合Mocha和WebdriverIO的配置，能实现完整的断点调试流程：

配置步骤： #

• 在项目根目录创建.vscode/launch.json文件，填入以下配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Debug Mocha Appium Tests",
      "program": "${workspaceFolder}/node_modules/mocha/bin/mocha",
      "args": [
        "--no-timeouts", // 禁用Mocha超时，避免调试时超时失败
        "${workspaceFolder}/test/specs/**/*.js" // 替换成你的测试文件路径
      ],
      "env": {
        "WDIO_DEBUG": "true" // 开启WebdriverIO的调试模式，输出更详细的会话日志
      },
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen",
      "skipFiles": ["<node_internals>/**"]
    }
  ]
}

使用方法： #

• 在测试代码的目标行左侧点击，添加断点（红色圆点）
• 打开VS Code的「运行和调试」面板，选择配置项Debug Mocha Appium Tests启动调试
• 测试运行到断点时自动暂停，此时可以：
  • 查看左侧「变量」面板里的所有局部变量、全局变量值
  • 使用顶部调试工具栏进行「单步跳过」「单步进入」「继续执行」等操作
  • 在「调试控制台」输入代码片段，实时执行并查看结果

2. WebdriverIO 内置browser.debug()命令（轻量终端调试） #

不需要IDE配置，直接在测试代码中插入browser.debug()，即可进入交互式调试模式：

示例代码： #

describe('登录流程测试', () => {
  it('验证用户名输入', async () => {
    await $('~登录按钮').click();
    // 插入调试断点，运行到此处会暂停
    await browser.debug();
    // 后续测试步骤
    const usernameInput = await $('~用户名输入框');
    await usernameInput.setValue('test_user');
  });
});

使用方法： #

• 正常运行测试命令（如npx wdio run wdio.conf.js）
• 测试执行到browser.debug()时会暂停，终端进入REPL交互模式
• 此时可以：
  • 直接输入变量名（如usernameInput）查看变量详情
  • 执行WebdriverIO命令（如await $('~密码输入框').getText()）实时操作设备
  • 输入continue继续执行后续测试，或输入.exit退出调试

3. Node.js 原生调试模式（Chrome DevTools 调试） #

通过Node.js的--inspect-brk参数启动Mocha，配合Chrome DevTools进行调试：

启动命令： #

node --inspect-brk node_modules/mocha/bin/mocha test/specs/your-test.js --no-timeouts

使用方法： #

• 打开Chrome浏览器，访问chrome://inspect
• 在「Remote Target」下找到你的测试进程，点击「inspect」打开DevTools
• 在Sources面板中找到测试文件，设置断点后即可开始调试，支持变量查看、单步执行等所有DevTools调试功能

以上三种方案都能满足你的本地调试需求，其中VS Code集成方案体验最流畅，适合日常开发；browser.debug()适合快速定位特定步骤的问题；Chrome DevTools调试则适合习惯浏览器调试界面的开发者。

内容的提问来源于stack exchange，提问作者Justas Tamulionis