跨平台开发 / 系统课时
模拟点击和文本输入
模拟点击和文本输入
本篇学习如何在 Flutter Widget 测试中模拟真实用户操作。通过 tap、enterText 等测试动作,可以验证按钮点击、表单输入以及操作后的界面变化是否符合预期。
学习目标
- 掌握 Widget 测试中的常用用户交互 API
- 学会组合输入、点击和页面刷新操作
- 能验证交互行为导致的状态变化
使用 tester 模拟用户操作
Widget 测试中的 WidgetTester 提供了模拟用户行为的方法。测试流程通常是:定位 Widget、执行动作、等待框架刷新、检查结果。
常见操作包括:
tap:模拟点击 WidgetenterText:向输入框输入文本pump:触发一次 Widget 更新pumpAndSettle:等待动画和异步更新完成
模拟输入和点击流程
下面示例创建一个简单登录区域,测试输入用户名后点击按钮,页面显示提交结果。
dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
class LoginPage extends StatefulWidget {
const LoginPage({super.key});
@override
State<LoginPage> createState() => _LoginPageState();
}
class _LoginPageState extends State<LoginPage> {
String message = '';
@override
Widget build(BuildContext context) {
return Column(
children: [
TextField(key: const Key('username')),
ElevatedButton(
key: const Key('submit'),
onPressed: () {
setState(() {
message = '已提交';
});
},
child: const Text('提交'),
),
Text(message),
],
);
}
}
void main() {
testWidgets('enter text and tap button', (tester) async {
await tester.pumpWidget(const MaterialApp(home: LoginPage()));
await tester.enterText(find.byKey(const Key('username')), 'flutter');
await tester.tap(find.byKey(const Key('submit')));
await tester.pump();
expect(find.text('已提交'), findsOneWidget);
});
}预期输出
text
00:00 +1: enter text and tap button
00:00 +1: All tests passed!处理异步界面变化
如果点击后触发网络请求、动画或 Future 更新,单次 pump 可能不足以等待页面稳定。这时应使用 pumpAndSettle 等待所有可完成的动画和异步更新结束。
dart
await tester.tap(find.byKey(const Key('submit')));
await tester.pumpAndSettle();避免交互测试中的常见问题
测试点击失败通常来自三个原因:
- Finder 找到了多个 Widget,导致无法确定目标。
- 操作后没有调用
pump,界面仍停留在旧状态。 - 输入框没有获得正确焦点,导致文本没有进入目标字段。
设计测试时,应优先给关键交互元素添加 Key,并让每次操作后的断言都验证真实用户可见结果。
按自己的节奏,确认真正理解。