使用 Jest it.each 在测试描述中引用测试数据变量

本文档介绍了如何在 Jest 框架中使用 it.each 方法时，在测试用例的描述信息中动态引用测试数据变量。通过两种不同的方法，你可以根据测试数据的不同，生成更具描述性的测试报告，从而提高测试结果的可读性和问题定位效率。

方法一：使用格式化字符串

it.each 方法允许你使用格式化字符串来动态生成测试用例的描述。这种方法适用于测试数据是简单类型（例如字符串、数字）的场景。

示例代码：

it.each([
  ["nice test", "nice test"],
  ["failed test", "nice failed test"],
])(
  "Should property and expectedResult be the same for property: %s",
  (property, expectedResult) => {
    expect(property).toBe(expectedResult);
  }
);

代码解释：

• it.each 接收一个二维数组作为参数，每一行代表一组测试数据。
• 第一个参数是一个格式化字符串，%s 是一个占位符，会被对应位置的测试数据替换。
• 第二个参数是一个回调函数，接收每一组测试数据作为参数，并执行断言。

注意事项：

• 格式化字符串中的占位符数量必须与测试数据的数量一致。
• 常用的占位符包括 %s (字符串), %d (数字), %j (JSON)。
• 这种方法更适用于简单的测试数据，如果测试数据是对象，建议使用第二种方法。

方法二：使用 describe.each 和模板字符串

当测试数据是对象时，可以使用 describe.each 结合模板字符串来动态生成测试用例的描述。这种方法更加灵活，可以方便地访问对象中的属性。

Veed Video Background Remover

Veed推出的视频背景移除工具

69

查看详情

示例代码：

describe.each([
  { property: 'nice test', expectedResult:'nice test' },
  { property: 'failed test', expectedResult: 'nice failed test' },
])('description', ({ property, expectedResult }) => {
  it(
    `Should property and expectedResult be the same for property: ${property}`,
    () => {
      expect(property).toBe(expectedResult);
    }
  );
})

代码解释：

• describe.each 接收一个数组作为参数，数组中的每个元素是一个对象，代表一组测试数据。
• 回调函数接收每一组测试数据对象，并使用对象解构的方式提取 property 和 expectedResult 属性。
• 在 it 函数的描述中使用模板字符串 ${property} 来动态插入 property 属性的值。

注意事项：

• describe.each 创建了一个新的测试套件，其中的 it 函数会被执行多次，每次使用不同的测试数据。
• 模板字符串使用反引号 (`) 包裹，可以在其中嵌入 JavaScript 表达式。
• 这种方法更加灵活，可以方便地访问对象中的属性，并生成更具描述性的测试报告。

总结

本文介绍了两种在 Jest it.each 方法中引用测试数据变量的方法：

1. 使用格式化字符串： 适用于简单类型的测试数据，例如字符串和数字。
2. 使用 describe.each 和模板字符串： 适用于对象类型的测试数据，更加灵活，可以方便地访问对象属性。

选择哪种方法取决于你的测试数据的类型和复杂程度。通过合理地使用这些技巧，你可以生成更具描述性的测试报告，提高测试结果的可读性和问题定位效率。

以上就是使用 Jest it.each 在测试描述中引用测试数据变量的详细内容，更多请关注php中文网其它相关文章！