无消息断言:失败不清晰
快速摘要
你的断言失败了但错误消息是通用的 —— 不清楚预期什么和收到了什么。
为什么发生
断言没有自定义消息,因此框架显示通用差异
断言复杂,默认消息未解释意图
一个测试中多个断言使不清楚哪个失败了
最小示例
✗ 错误代码
test('user profile', () => {
const user = getUser(1);
expect(user.name).toBe('Alice'); // unclear if this fails
expect(user.age).toBe(30); // or this fails
expect(user.email).toContain('@'); // or this
});✓ 修复代码
test('user name is correct', () => {
expect(getUser(1).name).toBe('Alice');
});
test('user age is correct', () => {
expect(getUser(1).age).toBe(30);
});
test('user email is valid', () => {
expect(getUser(1).email).toContain('@');
});将断言拆分为带描述名称的单独测试使清楚地知道哪个断言失败及为什么。
如何诊断
查看测试失败输出以确认消息是否解释了预期内容
检查一个测试中多个断言是否使难以识别失败的断言
为断言添加描述性消息以澄清意图
如何修复
为断言添加自定义消息:expect(value).toBe(expected, 'user age should match')
将多个断言拆分为带描述名称的单独测试用例
使用更具体的匹配器如 toContain 或 toMatchObject 以获得更好的错误输出
如何预防
始终为非显而易见的检查添加描述性消息
每个测试保持一个逻辑断言并使用描述性测试名称