如何屏蔽Node.js内置测试运行器的控制台输出？

针对你遇到的问题——使用node --test时想屏蔽测试代码中的console.log等输出，但保留测试运行器的摘要、计时信息，目前有几种原生可行的方案：

1. 单个测试/测试块内临时重写console #

在需要屏蔽输出的测试块或单个测试用例中，临时重写console方法，测试完成后恢复原方法，既不会影响其他测试，也能保留测试运行器的输出：

测试块级别屏蔽 #

const { describe, test } = require('node:test')
const assert = require('node:assert')
const originalLog = console.log

describe('hello', () => {
  // 进入测试块时禁用console.log
  before(() => {
    console.log = () => {}
  })

  // 测试块结束后恢复原方法
  after(() => {
    console.log = originalLog
  })

  test('can say hello', () => {
    console.log('Hello World') // 此输出会被屏蔽
    assert.equal(2 + 2, 4)
  })
})

单个测试用例级别屏蔽 #

如果只需要屏蔽某一个测试的输出，用try-finally确保无论测试是否失败都能恢复console：

const { describe, test } = require('node:test')
const assert = require('node:assert')

describe('hello', () => {
  test('can say hello', () => {
    const originalLog = console.log
    console.log = () => {}
    try {
      console.log('Hello World') // 此输出会被屏蔽
      assert.equal(2 + 2, 4)
    } finally {
      console.log = originalLog // 强制恢复原方法
    }
  })
})

2. 全局所有测试统一屏蔽 #

如果项目中所有测试都需要屏蔽console输出，可以创建一个测试前置文件，通过Node.js测试运行器的--test-setup参数（Node.js v20+支持）全局重写console：

1. 创建test.setup.js文件：

const originalLog = console.log
const originalError = console.error

// 全局禁用console.log，如需屏蔽其他方法可同理添加
console.log = () => {}

// 可选：保留console.error以便查看错误信息
// console.error = () => {}

// 测试结束后恢复原方法（可选，若不需要恢复可省略）
process.on('exit', () => {
  console.log = originalLog
  console.error = originalError
})

2. 运行测试时指定前置文件：

node --test --test-setup ./test.setup.js

为什么直接重定向stdout无效？ #

Node.js内置测试运行器的测试摘要、计时信息也是通过stdout输出的，直接将stdout重定向到/dev/null会同时屏蔽测试结果和冗余输出，而重写console方法仅拦截测试代码中的主动调用，不会影响测试运行器本身的输出逻辑。

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