Jest循环测试失败时如何打印触发失败的入参且避免test.each冗余

云原生阿岚

2026-10-2

方案1：使用Jest原生的自定义断言消息（最推荐，零额外改造）

Jest的expect方法支持传入第二个参数作为断言失败时的自定义提示信息，仅在断言失败时才会打印该内容，不会产生冗余日志，也不需要修改现有测试逻辑结构：

it('Full name must be >= 3 letters', () => {
  ['', 'a', 'ab', 'a ', 'a    ', '     a'].forEach((fullName) => {
    // 第二个参数传入自定义错误提示，JSON.stringify可清晰展示空格、空串等不可见字符
    expect(
      () => userBuilder.build({ fullName }),
      `断言失败，当前测试入参fullName为：${JSON.stringify(fullName)}`
    ).toThrowError();
  });
});

断言失败时自定义消息会和原生报错信息一起输出，可直接定位到失败的入参值。

方案2：封装通用循环断言工具（适合多同类测试批量复用）

如果有大量类似的循环测试场景，可以封装统一的工具函数，避免每个断言都重复写自定义消息：

// 通用工具函数，TS环境可根据需求补全泛型类型
function runTestCase<T>(input: T, assertFn: (input: T) => void) {
  try {
    assertFn(input);
  } catch (err) {
    // 给原始错误附加入参信息后再抛出
    (err as Error).message = `\n测试入参：${JSON.stringify(input)}\n${(err as Error).message}`;
    throw err;
  }
}

// 测试用例中使用
it('Full name must be >= 3 letters', () => {
  ['', 'a', 'ab', 'a ', 'a    ', '     a'].forEach((fullName) => {
    runTestCase(fullName, (val) => {
      expect(() => userBuilder.build({ fullName: val })).toThrowError();
    });
  });
});

该方案完全兼容ts-jest的TypeScript环境，所有循环测试都可以复用，维护成本更低。