JS 中怎么用参数化测试（test.each）高效验证多组输入输出-js教程-PHP中文网

Jest 的 test.each 是参数化测试语法糖，支持数组+模板字符串（%i占位符）和对象数组+解构（$key引用）两种写法，并可搭配 describe.each 分组组织测试，需注意参数匹配、异步处理及并行执行等细节。

js 中怎么用参数化测试（test.each）高效验证多组输入输出

Jest 的 test.each 是专门用于参数化测试的语法糖，能用一组数据驱动多个相同逻辑的测试用例，避免重复写 test，大幅提升可维护性和覆盖率。

基础写法：数组 + 模板字符串

最常用的是传入二维数组，每项是一组参数，配合带占位符的模板字符串描述用例：

test.each([
  [1, 2, 3],
  [0, 0, 0],
  [-1, 1, 0],
])('add(%i, %i) returns %i', (a, b, expected) => {
  expect(a + b).toBe(expected);
});

说明：
- %i 是 Jest 内置占位符（%s 字符串、%j JSON），自动格式化对应参数；
- 每个子数组对应一次执行，Jest 会生成独立测试名，失败时精准定位哪组数据出错。

进阶写法：对象数组 + 解构

当参数多或语义复杂时，用对象数组更清晰：

Expanso json-flatten

通过 CLI 或 MCP 服务器，使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

test.each([
  { input: 'hello', output: 'HELLO' },
  { input: 'WORLD', output: 'WORLD' },
  { input: '  js  ', output: 'JS' },
])('toUpperCase($input) → $output', ({ input, output }) => {
  expect(input.trim().toUpperCase()).toBe(output);
});

说明：
- 模板中用 $key 引用对象属性，支持嵌套（如 $user.name）；
- 解构参数让断言逻辑更易读，适合校验函数行为、API 响应结构等场景。

搭配 describe.each 实现分层组织

若需对同一函数在不同场景下批量测试（比如边界值、异常输入），可用 describe.each 分组：

describe.each([
  ['positive', [1, 2, 3]],
  ['negative', [-1, -2, -3]],
  ['mixed', [1, -1, 0]],
])('sum %s numbers', (_, numbers) => {
  test('returns correct total', () => {
    expect(numbers.reduce((a, b) => a + b, 0)).toBe(
      numbers.length > 0 ? numbers.reduce((a, b) => a + b, 0) : 0
    );
  });
<p>test('handles empty array', () => {
expect([].reduce((a, b) => a + b, 0)).toBe(0);
});
});</p>

说明：
- 第一个参数是描述性标签（如 'positive'），第二个是实际数据；
- 每组 describe 下可包含多个 test，共享上下文又保持数据隔离。