跨平台开发 / 系统课时
处理 pump 和动画等待
处理 pump 和动画等待
Flutter Widget 测试经常需要等待界面刷新、异步任务完成或动画结束。本篇通过理解 pump 与 pumpAndSettle 的差异,帮助你编写稳定的异步界面测试,避免因为等待时机错误导致测试偶发失败。
学习目标
- 理解 Widget 测试中 frame 推进与异步等待的关系
- 掌握 pump、pumpAndSettle 的适用场景
- 能够排查动画和异步更新导致的不稳定测试
理解测试中的界面推进
Flutter 的 Widget 测试不会像真实应用一样自动等待界面变化。调用 pump 相当于告诉测试框架推进一次 Flutter frame,让组件重新构建并处理当前队列中的更新。
当测试涉及按钮点击、状态变化或 Future 返回结果时,通常需要主动调用等待方法,否则断言可能发生在界面更新之前。
例如,一个按钮点击后修改文本的组件:
dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
class CounterPage extends StatefulWidget {
const CounterPage({super.key});
@override
State<CounterPage> createState() => _CounterPageState();
}
class _CounterPageState extends State<CounterPage> {
int count = 0;
void increment() {
setState(() {
count++;
});
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: Column(
children: [
Text('$count'),
ElevatedButton(
onPressed: increment,
child: const Text('add'),
),
],
),
);
}
}
void main() {
testWidgets('button updates text', (tester) async {
await tester.pumpWidget(const MaterialApp(home: CounterPage()));
await tester.tap(find.text('add'));
await tester.pump();
expect(find.text('1'), findsOneWidget);
});
}预期结果
text
testWidgets 通过,断言找到文本 1这里的 pump() 只负责推进一次更新。它不会无限等待动画,也不会等待所有异步任务完成。
区分 pump 和 pumpAndSettle
两个方法的主要区别是等待范围不同。
| 方法 | 行为 | 适用场景 |
|---|---|---|
pump() |
推进一次 frame | 验证一次状态变化、手动控制动画进度 |
pumpAndSettle() |
持续 pump,直到没有待处理 frame | 等待页面跳转、动画结束、连续异步更新 |
pumpAndSettle() 适合测试最终稳定状态,例如打开页面后等待 Hero 动画完成,再检查最终布局。
但它不是所有场景的默认选择。如果页面存在无限动画,例如循环加载动画,pumpAndSettle() 会一直等待,导致测试超时。
控制动画时间
对于需要验证动画过程的测试,可以给 pump 传入 Duration,让测试时间向前推进。
dart
await tester.pump(const Duration(milliseconds: 300));这表示模拟经过 300 毫秒后的界面状态,而不是让测试真实等待 300 毫秒。
什么时候不该使用 pumpAndSettle
以下情况更适合使用精确的 pump:
- 页面包含循环动画或定时刷新
- 需要验证动画中间状态
- 需要控制多个异步步骤的执行顺序
稳定的测试通常不是等待越久越好,而是明确知道组件什么时候应该变化,并推进到对应状态。
按自己的节奏,确认真正理解。