本文档介绍了如何在 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 结合模板字符串来动态生成测试用例的描述。这种方法更加灵活，可以方便地访问对象中的属性。
示例代码：
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 方法中引用测试数据变量的方法：
- 使用格式化字符串： 适用于简单类型的测试数据，例如字符串和数字。
- 使用 describe.each 和模板字符串： 适用于对象类型的测试数据，更加灵活，可以方便地访问对象属性。
选择哪种方法取决于你的测试数据的类型和复杂程度。通过合理地使用这些技巧，你可以生成更具描述性的测试报告，提高测试结果的可读性和问题定位效率。
