Jest、--verbose参数与console.log的交互规则及输出时机说明

基础前提 #

Jest 运行测试时会默认劫持全局 console 对象，所有 console.log/console.info 等调用不会直接调用Node原生console方法，而是先被Jest缓存，再按照自身规则统一打印。不同大版本（25/26/28为三个行为分界点）的具体实现有调整，官方文档未同步更新，这也是社区反馈表现不一致的核心原因。

核心输出规则 #

console 输出不存在“始终输出”或“仅失败输出”的默认逻辑，输出位置、时机完全由代码所在的执行上下文决定：

• 代码位于测试文件顶层作用域（不在任何test/it用例块、beforeAll/beforeEach/afterEach/afterAll钩子块内部）：模块加载阶段就会执行，输出会在整个测试文件的所有测试结果之前打印，和具体用例无绑定关系，和代码写在测试用例前/后没有关联——哪怕把顶层console写在文件最末尾，只要不在块级作用域内，依然会最先输出。
• 代码位于用例块、测试钩子内部，或者位于被测试的业务源码中、被用例逻辑调用：输出会绑定到对应的测试用例，等该用例所属测试套件的所有用例执行完成后统一归类打印。
• 启动时添加--silent参数时，所有console输出会被完全屏蔽，优先级最高。

与 --verbose 参数的交互逻辑 #

--verbose 参数本身只控制测试结果的展示粒度，不会直接开关console输出，二者的关联表现如下：

• 多测试文件运行时--verbose默认开启，单文件运行时默认关闭。
• 开启--verbose时，Jest会逐行展示每个用例的通过/失败状态，绑定到用例的console输出会紧跟在对应用例的结果行之后打印，缩进和用例结果对齐，方便定位日志所属用例。
• 关闭--verbose时，Jest会折叠所有通过用例的结果，只展示失败用例详情，但不会隐藏通过用例绑定的console输出：所有绑定到用例的日志（不管用例成功失败）会统一堆在测试套件结果的末尾打印，不会和单个用例结果做对应展示。
• 顶层作用域的console输出完全不受--verbose参数影响，永远在所有测试结果之前打印。

实现“仅失败用例展示console输出”的方案 #

Jest默认没有提供对应配置项，可以通过全局setup脚本自定义实现：

1. 在Jest配置中添加setupFilesAfterEach: ['./jest.setup.js']
2. 在jest.setup.js中写入如下逻辑，缓存所有console调用，仅当用例失败时打印：

const nativeConsole = global.console;
const logCache = [];

// 劫持常用console方法，缓存输出
['log', 'info', 'warn', 'error'].forEach(method => {
  global.console[method] = (...args) => {
    logCache.push({ method, args });
  };
});

// 每个用例执行完成后判断状态，失败才输出缓存日志
afterEach(() => {
  const currentTestState = expect.getState();
  if (currentTestState.failed) {
    logCache.forEach(({ method, args }) => {
      nativeConsole[method](...args);
    });
  }
  // 清空缓存供下一个用例使用
  logCache.length = 0;
});

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