如何通过Node.js exec子进程执行终端命令后恢复Nightwatch测试

当然可行啦！你碰到的这个问题，十有八九是因为自定义命令里的终端命令没处理好异步逻辑，把Nightwatch的测试流程给阻塞住了。别担心，我给你一步步拆解解决办法：

先搞懂问题根源 #

如果你的自定义命令里用了execSync或者spawnSync这类同步执行终端命令的方法，它们会直接阻塞Node.js的事件循环——相当于整个测试进程都等着命令跑完，跑完之后还没告诉Nightwatch“我搞定了，继续走”，就导致测试卡住不动了。

要是用了异步版本的exec/spawn但没调用Nightwatch的回调函数，Nightwatch也不知道命令什么时候执行完，自然会停在这儿等。

正确的解决姿势：异步执行+回调通知 #

Nightwatch的自定义命令天生支持异步，只要在命令里正确调用回调，就能让测试流程继续走下去。下面给你两个常用场景的示例：

场景1：执行简单终端命令（用exec） #

先写好自定义命令文件（比如放在custom_commands/runTerminalCmd.js）：

const { exec } = require('child_process');

exports.command = function(cmd, callback) {
  const self = this;
  
  exec(cmd, (error, stdout, stderr) => {
    // 处理命令执行中的错误和输出
    if (error) {
      console.error(`命令执行出错：${error.message}`);
      // 可选：直接标记测试失败
      // self.api.assert.fail(`终端命令执行失败：${error.message}`);
    }
    if (stderr) console.error(`命令错误输出：${stderr}`);
    if (stdout) console.log(`命令正常输出：${stdout}`);
    
    // 关键！通知Nightwatch命令执行完成
    if (typeof callback === 'function') {
      callback.call(self, stdout, stderr);
    }
    
    // 返回self保证链式调用正常
    return self;
  });
};

然后在测试用例里这样用：

it('Should have Stream URL, Stream Key and Status...', function(browser) {
  browser
    .url('你的测试页面地址')
    // 调用自定义命令执行终端命令，可选传回调处理输出
    .runTerminalCmd('你的终端命令，比如echo "hello"', (stdout) => {
      console.log('终端命令跑完啦，输出是：', stdout);
    })
    // 继续执行后续测试步骤
    .assert.visible('#stream-url')
    .assert.visible('#stream-key')
    .assert.containsText('#status', '在线')
    .end();
});

场景2：执行输出较多的命令（用spawn） #

如果终端命令会输出大量内容（比如打包、日志类命令），用spawn更稳定，同样要处理回调：

// custom_commands/runSpawnCmd.js
const { spawn } = require('child_process');

exports.command = function(cmd, args, callback) {
  const self = this;
  const cmdProcess = spawn(cmd, args);
  
  let fullStdout = '';
  let fullStderr = '';
  
  // 捕获标准输出
  cmdProcess.stdout.on('data', (chunk) => {
    const content = chunk.toString();
    fullStdout += content;
    console.log(`命令输出：${content}`);
  });
  
  // 捕获错误输出
  cmdProcess.stderr.on('data', (chunk) => {
    const content = chunk.toString();
    fullStderr += content;
    console.error(`命令错误输出：${content}`);
  });
  
  // 命令执行完成时触发
  cmdProcess.on('close', (exitCode) => {
    console.log(`命令执行结束，退出码：${exitCode}`);
    // 通知Nightwatch继续
    if (typeof callback === 'function') {
      callback.call(self, fullStdout, fullStderr, exitCode);
    }
    return self;
  });
};

测试用例里调用：

browser.runSpawnCmd('ls', ['-la', '/usr'], (stdout) => {
  console.log('目录列表：', stdout);
})

几个必须注意的点 #

• 绝对别用同步方法：execSync/spawnSync会把整个进程卡住，测试肯定停住不动。
• 必须返回self：自定义命令里一定要return self，不然Nightwatch的链式调用会失效。
• 错误处理要灵活：如果命令执行失败，你可以选择标记测试失败，或者忽略错误继续执行，根据你的测试需求来定。

这样修改之后，终端命令执行完就会自动把控制权交还给Nightwatch，后续的测试步骤就能正常跑起来啦！

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