跨平台开发 / 系统课时

模拟点击和文本输入

模拟点击和文本输入

本篇学习如何在 Flutter Widget 测试中模拟真实用户操作。通过 tap、enterText 等测试动作,可以验证按钮点击、表单输入以及操作后的界面变化是否符合预期。

学习目标

  • 掌握 Widget 测试中的常用用户交互 API
  • 学会组合输入、点击和页面刷新操作
  • 能验证交互行为导致的状态变化

使用 tester 模拟用户操作

Widget 测试中的 WidgetTester 提供了模拟用户行为的方法。测试流程通常是:定位 Widget、执行动作、等待框架刷新、检查结果。

常见操作包括:

  • tap:模拟点击 Widget
  • enterText:向输入框输入文本
  • 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,并让每次操作后的断言都验证真实用户可见结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

模拟点击和文本输入

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

登录哪都通