跨平台开发 / 系统课时

处理 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:

  • 页面包含循环动画或定时刷新
  • 需要验证动画中间状态
  • 需要控制多个异步步骤的执行顺序

稳定的测试通常不是等待越久越好,而是明确知道组件什么时候应该变化,并推进到对应状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理 pump 和动画等待

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

登录哪都通