跨平台开发 / 系统课时

等待 Future 的成功结果

等待 Future 的成功结果

异步函数返回 Future 后,测试不能只发起调用就结束,否则结果可能还没产生,测试就已经完成。本文用 package:test 演示两种可靠写法:直接 await 返回值,以及用 completion 匹配器等待 Future 完成。

学习目标

  • 使用 await 等待 Future 成功完成后再执行断言
  • 使用 completion 直接验证 Future 的完成值
  • 避免因遗漏异步等待导致测试提前结束

先把 Future 变成可断言的结果

Dart 的异步函数调用立即返回 Future<T>,真正的值要等 Future 完成后才能取得。测试的关键不是延迟固定时间,而是让测试函数本身等待这个 Future。

当后续还要对结果执行多个检查时,最直接的方式是先 await:Future 完成后得到普通值,再用常规 matcher 断言。只需要验证完成值时,也可以把 Future 直接交给 completion。

用 await 和 completion 验证成功结果

下面的测试文件包含两种写法。示例假设项目已经在 dev_dependencies 中配置 test 包,可保存为 test/future_success_test.dart 后运行。

dart
import 'package:test/test.dart';

Future<String> fetchUserName() async {
  // 模拟一次需要等待才能得到结果的异步操作。
  await Future<void>.delayed(const Duration(milliseconds: 20));
  return 'Ada';
}

void main() {
  test('directly awaits the Future value', () async {
    final name = await fetchUserName();

    // await 完成后,name 已经是普通 String,可以继续做多个断言。
    expect(name, 'Ada');
    expect(name.length, 3);
  });

  test('matches Future completion', () async {
    await expectLater(
      fetchUserName(),
      completion('Ada'),
    );
  });
}

预期输出

text
<TIME> +1: directly awaits the Future value
<TIME> +2: matches Future completion
<TIME> +2: All tests passed!

测试运行时的时间前缀可能不同,因此这里用 <TIME> 表示动态值。两个测试都只有在对应的 Future 完成并通过断言后才会结束。

两种写法怎么选

await 更适合需要保存结果、执行多个断言或继续调用其他逻辑的场景。它把异步边界显式展开,调试失败测试时也更容易看到具体哪一个断言不成立。

completion 适合只关心 Future 最终完成值的短测试。completion('Ada') 的含义是:等待这个 Future 成功完成,并检查完成值是否等于 Ada。如果 Future 以异常结束,该断言同样会失败。

避免测试提前结束

异步测试的回调应声明为 async,并等待需要验证的异步操作。特别是使用 expectLater 时,应 await 它返回的 Future,让测试框架知道异步匹配尚未结束。

不要通过额外调用 Future.delayed 猜测业务 Future 什么时候完成。固定延迟既会拖慢测试,也会在机器负载变化时变得不稳定。正确做法是等待真正代表业务完成状态的 Future,然后再断言结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

等待 Future 的成功结果

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

登录哪都通