flutter中的ListView单元测试

在 Flutter 中，你可能会希望测试 ListView 内容是否如预期那样显示，是否能够正确滚动，以及是否处理用户输入。以下是测试 ListView 的一些基本步骤：

测试 ListView 的内容

这涉及到确认 ListView 是否显示了正确数量的项，以及这些项是否包含正确的数据。

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

void main() {
  testWidgets('ListView builds correct number of items', (WidgetTester tester) async {
    // 定义测试数据。
    final List<String> items = ['Item 1', 'Item 2', 'Item 3'];

    // 构建测试 Widget。
    await tester.pumpWidget(MaterialApp(
      home: Scaffold(
        body: ListView(
          children: items.map((item) => Text(item)).toList(),
        ),
      ),
    ));

    // 检查 ListView 是否显示了正确数量的 Text Widget。
    expect(find.byType(Text), findsNWidgets(items.length));

    // 验证特定数据是否存在
    for (final item in items) {
      expect(find.text(item), findsOneWidget);
    }
  });
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

测试 ListView 的滚动行为

你可以使用 tester 对象上的 scroll 方法模拟用户滚动行为。

testWidgets('ListView can be scrolled', (WidgetTester tester) async {
  final List<String> items = List.generate(20, (index) => 'Item $index');

  // 构建测试 Widget。
  await tester.pumpWidget(MaterialApp(
    home: Scaffold(
      body: ListView.builder(
        itemCount: items.length,
        itemBuilder: (BuildContext context, int index) {
          return ListTile(title: Text(items[index]));
        },
      ),
    ),
  ));

  // 验证第一个元素是否存在。
  expect(find.text('Item 0'), findsOneWidget);

  // 进行滚动，滚动距离大于可视区域的高度。 
  await tester.drag(find.byType(ListView), const Offset(0, -300));
  await tester.pumpAndSettle(); // 等待滚动动画完成。

  // 验证第一个元素是否不再显示。
  expect(find.text('Item 0'), findsNothing);
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

测试 ListView 的交互

例如，你可能想要测试点击 ListView 中的一个项目是否触发了期望的动作。

testWidgets('ListView item tap triggers a callback', (WidgetTester tester) async {
  final List<String> items = ['Item 1', 'Item 2'];
  String selectedItem = '';

  // 构建测试 Widget。
  await tester.pumpWidget(MaterialApp(
    home: Scaffold(
      body: ListView.builder(
        itemCount: items.length,
        itemBuilder: (BuildContext context, int index) {
          return ListTile(
            title: Text(items[index]),
            onTap: () {
              selectedItem = items[index];
            },
          );
        },
      ),
    ),
  ));

  // 模拟用户点击第二个 ListTile。
  await tester.tap(find.text('Item 2'));
  await tester.pump();

  // 验证回调是否按预期运行。
  expect(selectedItem, 'Item 2');
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

以上是几个基本的测试场景。实际中，你可能有更复杂的 ListView 构造，比如那些使用了自定义 delegate，或者有头部和尾部、分隔线等更复杂的 ListView。要测试这些构造，只需构建适当的场景，并使用 flutter_test 提供的工具来模拟用户的行为和检查 Widget 状态。