知识卡片
断言失败应显示实际与期望
断言失败信息应尽量直接显示实际值和期望值,让维护者不用先重跑或逐步调试才能知道差异。优先使用合适的断言能力,并保持输出可辨认。错误消息格式受框架和版本影响,原则是提供足够定位信息,而不是依赖某个历史报错字符串。
多个用例共享辅助函数时,还应保留触发失败的输入或情形标识。定制断言可集中展示输入、期望与实际,帮助直接关联失败用例。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 2 处
- · 查看原书依据
更具体的消息: 这更有帮助。 如果有的话,你应该使用这些更有帮助的断言方法。每当你的测试失败时,你就会受益。 其他语言中更好的ASSERT()选择 在Python中,内置语句assert a==b会产生一条简单的错误消息: 不如用unittest模块中的assertEq
- · 查看原书依据
触发这个错误的输入一定会有帮助。理想的错误消息可以像是这样: 如果这就是你想要的,那么就写出来吧! 这个故事的寓意就是错误消息应当越有帮助越好。有时,通过建立“定制的断言”来输出你自己的消息是最好的方式。
参考来源
- 位置:《编写可读代码的艺术》失败信息要显示比较值(spine 2878;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2799.html`;来源键`s2878-ch14-004`)。
- 结论依据:本项正文与图330..368逐幅完整实读;测试例均为阅读和计划材料,未声称已执行测试或验证覆盖率。
- 原始内容:更具体的消息: 这更有帮助。 如果有的话,你应该使用这些更有帮助的断言方法。每当你的测试失败时,你就会受益。 其他语言中更好的ASSERT()选择 在Python中,内置语句assert a==b会产生一条简单的错误消息: 不如用unittest模块中的assertEq
- 位置:《编写可读代码的艺术》必要时加入触发失败的输入(spine 2879;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2800.html`;来源键`s2879-ch14-004`)。
- 结论依据:本项正文与图330..368逐幅完整实读;测试例均为阅读和计划材料,未声称已执行测试或验证覆盖率。
- 原始内容:触发这个错误的输入一定会有帮助。理想的错误消息可以像是这样: 如果这就是你想要的,那么就写出来吧! 这个故事的寓意就是错误消息应当越有帮助越好。有时,通过建立“定制的断言”来输出你自己的消息是最好的方式。