跨平台开发 / 系统课时
等待 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 后运行。
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'),
);
});
}预期输出
<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,然后再断言结果。