跨平台开发 / 系统课时

验证 Future 的异常分支

验证 Future 的异常分支

异步代码不仅要验证成功结果,还要确认失败条件会产生预期异常。对于返回 Future 的 API,异常通常在 Future 完成时出现。本文使用 throwsA 与 expectLater 同时检查异常类型和错误信息,覆盖真实的失败路径。

学习目标

  • 正确等待 Future 以异常结束并执行断言
  • 使用 throwsA 验证异步异常的具体类型
  • 进一步检查异常携带的信息,避免只验证发生了任意错误

异步异常需要等待 Future 完成

调用异步函数时,拿到的是一个 Future。即使错误由函数内部的参数校验触发,只要函数声明为 async,测试也应把它作为异步结果处理,而不是假定异常会在调用表达式处同步抛出。

测试错误分支时,重点通常有两层:先确认确实失败,再确认失败原因正确。只使用能够匹配任意异常的断言虽然能提高覆盖率,却可能让错误的异常类型也通过测试。

验证异常类型和触发条件

下面定义一个简单的校验异常。当 userId 小于等于 0 时,异步操作应以 ValidationException 结束,并携带明确的错误信息。

dart
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',
        ),
      ),
    );
  });
}

预期输出

text
<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,可以把触发条件、异常类型和验证结果放在同一条测试链路中,使失败原因更明确,也能保持测试稳定。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

验证 Future 的异常分支

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通