SuperAPI AI 工具集

unit-test-utility-methods

测试与质量

查看项目

更新于 10-15 21:52

技能介绍

用途:该技能用于为工具类、静态辅助方法和纯函数生成单元测试,提供针对空值处理、边界条件以及字符串操作、计算、数据校验、集合等常见工具类的测试模式。纯函数无需 mock。

主要能力:覆盖正常路径、边界条件(null、空串、空白、单元素、最大最小值、精度)的测试写法;推荐使用描述性测试名、AssertJ 断言与 @ParameterizedTest 处理多组相似输入;对含外部依赖(如 Clock)的工具类可进行 mock。

使用方式:按工具类命名测试类(如 StringUtilsTest);先测正常输入与预期输出,再测边界与空值;用 shouldCapitalizeFirstLetter 这类描述性名称;纯工具避免 mock,仅对外部依赖使用 mock。

适用场景:字符串格式化与转换、计算与转换、数据校验与格式化、集合或数组辅助方法等工具代码的测试。

限制:不建议 mock 静态方法;有状态工具较难测试,优先不可变;浮点比较不可用精确相等,应使用 isCloseTo(delta);需明确工具返回 null 还是抛异常并据此测试;静态工具须线程安全,并发行为需单独验证;应说明工具是否修改入参。更多边界模式见 references/edge-cases.md。