跨平台开发 / 系统课时
验证 Future 的异常分支
验证 Future 的异常分支
异步代码不仅要验证成功结果,还要确认失败条件会产生预期异常。对于返回 Future 的 API,异常通常在 Future 完成时出现。本文使用 throwsA 与 expectLater 同时检查异常类型和错误信息,覆盖真实的失败路径。
学习目标
- 正确等待 Future 以异常结束并执行断言
- 使用
throwsA验证异步异常的具体类型 - 进一步检查异常携带的信息,避免只验证发生了任意错误
异步异常需要等待 Future 完成
调用异步函数时,拿到的是一个 Future。即使错误由函数内部的参数校验触发,只要函数声明为 async,测试也应把它作为异步结果处理,而不是假定异常会在调用表达式处同步抛出。
测试错误分支时,重点通常有两层:先确认确实失败,再确认失败原因正确。只使用能够匹配任意异常的断言虽然能提高覆盖率,却可能让错误的异常类型也通过测试。
验证异常类型和触发条件
下面定义一个简单的校验异常。当 userId 小于等于 0 时,异步操作应以 ValidationException 结束,并携带明确的错误信息。
import 'package:test/test.dart';
class ValidationException implements Exception {
ValidationException(this.message);
final String message;
@override
String toString() => 'ValidationException: $message';
}
Future<String> loadUser(int userId) async {
// 模拟请求在异步边界之后执行参数校验。
await Future<void>.delayed(const Duration(milliseconds: 20));
if (userId <= 0) {
throw ValidationException('userId must be positive');
}
return 'user-$userId';
}
void main() {
test('rejects a non-positive user id', () async {
await expectLater(
loadUser(0),
throwsA(
isA<ValidationException>().having(
(error) => error.message,
'message',
'userId must be positive',
),
),
);
});
}预期输出
<TIME> +1: rejects a non-positive user id
<TIME> +1: All tests passed!时间前缀属于测试运行时产生的动态信息,因此以 <TIME> 表示。测试通过说明 loadUser(0) 确实以指定类型的异常结束,而且异常中的 message 与预期一致。
throwsA 在检查什么
throwsA 接收另一个 matcher,用来描述允许出现的异常。isA<ValidationException>() 将范围限制到指定类型,随后通过 having 提取 message 属性并继续匹配其内容。
这种写法比只判断发生异常更有价值。例如代码因为空指针、状态错误或实现缺陷意外失败时,测试不会因为同样出现异常而误判为正确行为。
对于网络请求失败,可以用相同方式检查自定义请求异常的状态信息;对于输入校验,可以检查异常类型和业务字段。断言应关注调用方依赖的稳定语义,而不是绑定一整段可能频繁修改的调试文本。
不要丢失 expectLater 的等待
expectLater 返回 Future。异步测试中应等待它完成,否则测试函数可能先返回,使失败发生在测试生命周期之外,造成漏报或难以理解的异步错误。
错误路径也不应通过固定延迟等待异常出现。让 matcher 直接观察目标 Future,可以把触发条件、异常类型和验证结果放在同一条测试链路中,使失败原因更明确,也能保持测试稳定。