跨平台开发 / 系统课时

覆盖加载、空态和错误状态

覆盖加载、空态和错误状态

同一个页面在请求进行中、返回空数据或发生错误时,应该呈现完全不同的界面。与其在一个测试里不断切换状态,不如把业务状态变成可控输入,并为每种状态建立独立断言,这样失败时能直接定位是哪一种界面契约被破坏。

学习目标

  • 把加载、空态和错误态转换成可直接注入 Widget 的测试输入
  • 使用 testWidgets、Finder 和 Matcher 分别验证三种状态
  • 运行测试并根据失败用例定位界面回归

把业务状态变成可控输入

Widget 测试最稳定的做法,是让页面只负责根据状态渲染 UI,而不是在测试里真正发起网络请求。这样测试关注的是“状态到界面”的映射,不会被网络速度、后端数据或重试策略干扰。

下面的示例把三种业务状态定义为 LoadState,并让 ResultPage 根据状态渲染进度指示器、空态文案或错误文案。测试文件本身包含页面实现,因此可以直接放入 Flutter 项目的 test/result_page_test.dart 运行。

dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';

enum LoadState { loading, empty, error }

class ResultPage extends StatelessWidget {
  const ResultPage({super.key, required this.state});

  final LoadState state;

  @override
  Widget build(BuildContext context) {
    switch (state) {
      case LoadState.loading:
        return const Scaffold(
          body: Center(
            child: CircularProgressIndicator(
              key: ValueKey('loading-indicator'),
            ),
          ),
        );
      case LoadState.empty:
        return const Scaffold(
          body: Center(child: Text('暂无数据')),
        );
      case LoadState.error:
        return const Scaffold(
          body: Center(
            child: Text(
              '加载失败,请稍后重试',
              key: ValueKey('error-message'),
            ),
          ),
        );
    }
  }
}

void main() {
  Widget buildPage(LoadState state) {
    return MaterialApp(home: ResultPage(state: state));
  }

  testWidgets('加载状态显示进度指示器', (tester) async {
    await tester.pumpWidget(buildPage(LoadState.loading));

    expect(find.byKey(const ValueKey('loading-indicator')), findsOneWidget);
    expect(find.text('暂无数据'), findsNothing);
    expect(find.byKey(const ValueKey('error-message')), findsNothing);
  });

  testWidgets('空态显示空数据文案', (tester) async {
    await tester.pumpWidget(buildPage(LoadState.empty));

    expect(find.text('暂无数据'), findsOneWidget);
    expect(find.byKey(const ValueKey('loading-indicator')), findsNothing);
  });

  testWidgets('错误状态显示错误文案', (tester) async {
    await tester.pumpWidget(buildPage(LoadState.error));

    expect(find.byKey(const ValueKey('error-message')), findsOneWidget);
    expect(find.text('加载失败,请稍后重试'), findsOneWidget);
  });
}

这里不仅断言目标元素存在,也检查不应该出现的元素确实不存在。这样可以发现“错误态文案出现了,但加载动画没有被移除”这类容易漏掉的状态叠加问题。

运行并验证三种状态

在项目根目录执行测试文件:

bash
flutter test test/result_page_test.dart

预期输出的关键结果如下,实际耗时可能不同:

text
<TIME> +3: All tests passed!

三个测试彼此独立,所以其中一个状态回归时,测试报告会直接指出对应的用例,而不会把多个状态的失败混在一次长流程里。

让状态测试保持稳定

优先用语义明确且稳定的 ValueKey 查找关键控件,例如 loading-indicator。用户可见文案可以直接用 find.text 验证,但如果文案经常因国际化或产品调整而变化,不应把所有定位都绑在字符串上。

对于加载状态,不要无条件调用 pumpAndSettle():持续旋转的 CircularProgressIndicator 会不断安排动画帧,测试可能一直等不到“完全稳定”。这里只需要 pumpWidget() 完成首次构建,就足以验证加载 UI。

当页面真实状态来自 Provider、Bloc、Riverpod 或 ViewModel 时,原则不变:在 Widget 测试中注入可预测的状态或替身,让每个用例只验证一种业务状态对应的可见结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

覆盖加载、空态和错误状态

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

登录哪都通