Node.js Test Runner与TAP协议：成功测试能否打印指定实际/预期值？

TAP协议是否允许该操作？ #

是的，TAP协议完全支持这种需求。TAP的核心规范仅要求测试结果以ok/not ok开头标记状态，同时允许通过**#开头的注释**添加任意附加信息——这些注释会被TAP解析器忽略，不会影响测试结果的判定，但可以被人或自定义工具读取。

你可以在指定的成功测试结果后添加注释来输出Actual/Expected值，既符合TAP协议规范，又能满足查看关键测试验证细节的需求。

Node.js Test Runner API能否实现此需求？ #

可以，有两种实用的实现方式：

1. 手动在测试用例中输出TAP注释 #

直接在需要展示细节的测试用例里，断言通过后打印符合TAP格式的注释，示例代码：

import { test } from 'node:test';
import assert from 'node:assert';

test('无需输出细节的测试', (t) => {
  assert.strictEqual(1 + 1, 2);
});

test('需要验证Actual/Expected的测试', (t) => {
  const actual = 5 * 2;
  const expected = 10;
  assert.strictEqual(actual, expected);
  // 用TAP注释格式输出，不破坏协议结构
  console.log(`# Actual: ${actual}, Expected: ${expected}`);
});

运行测试后，指定测试的输出会包含这条注释，其他成功测试保持简洁。

2. 自定义TAP报告器（批量控制更优雅） #

如果需要批量标记测试或统一输出格式，可以自定义报告器继承Node.js默认的TAP报告器，重写测试通过的处理逻辑：

// custom-tap-reporter.js
import { TapReporter } from 'node:test/reporters';

export default class CustomTapReporter extends TapReporter {
  onTestPass(test) {
    // 先调用默认逻辑输出基础TAP结果
    super.onTestPass(test);
    // 检查测试是否带有自定义标记
    if (test.context.showOutput) {
      // 从测试的断言记录中获取Actual和Expected
      const lastAssertion = test.assertions.at(-1);
      if (lastAssertion) {
        this.write(`# Actual: ${JSON.stringify(lastAssertion.actual)}, Expected: ${JSON.stringify(lastAssertion.expected)}\n`);
      }
    }
  }
}

运行测试时指定该报告器：

node --test --test-reporter ./custom-tap-reporter.js

使用时给需要输出的测试添加标记：

test('带标记的测试', { context: { showOutput: true } }, (t) => {
  assert.deepStrictEqual({ a: 1 }, { a: 1 });
});

这种方式可以统一控制哪些测试输出详细信息，避免在测试用例里重复写打印逻辑。

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