NodeJS原生测试运行器TAP输出被截断的原因及解决方法

Node.js内置的原生测试运行器可通过--test标志启用：

node --test

该命令默认输出TAP 13格式内容到stdout，但会出现输出被截断的情况，多处用...标识省略内容：

not ok 1 - misc
   ---
   duration_ms: 5.883684
   failureType: 'subtestsFailed'
   error: '1 subtest failed'
   code: 'ERR_TEST_FAILURE'
   ...

即使将输出重定向到文件，或使用node:test模块的run函数手动指定测试文件，截断问题仍会出现。

问题原因 #

这是Node.jsnode:test模块的内置行为：为了避免输出过于冗长，默认的TAP reporter会自动截断较长的输出内容，尤其是子测试的详细信息，和终端显示、输出重定向无关。

可行解决办法 #

• 使用--test-reporter=verbose标志
  运行测试时添加该参数，可强制输出完整的TAP内容，不会截断：

  node --test --test-reporter=verbose
  

  重定向到文件时同样适用：

  node --test --test-reporter=verbose > temp.tap
  

• 通过node:test模块配置修改reporter
  若使用run函数编写自定义测试启动逻辑，可在配置中指定verbose reporter：

  import { run } from 'node:test';
  
  run({
    reporter: 'verbose'
  }).then(results => {
    process.exit(results.success ? 0 : 1);
  });
  

• 自定义TAP reporter（进阶）
  如果需要高度定制化的输出格式，可以实现自定义reporter，完整处理所有测试输出内容，从根源上避免截断。该方式适合有特殊输出需求的场景。

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