Widget 测试

type

status

date

slug

summary

添加一个 flutter_test 依赖

我们开始编写测试之前，需要先给 pubspec.yaml 文件的 dev_dependencies 段添加 flutter_test 依赖。如果使用命令行或编译器新建一个 Flutter 项目，那么依赖已经默认添加了。

创建一个测试用的 Widget

接下来，我们需要创建一个可以测试的 widget！在此例中，我们创建了一个 widget 显示一个 标题 (title)

创建一个 testWidgets 测试方法

现在我们有了一个可以测试的 widget，可以开始编写第一个测试了！第一步，我们用 flutter_test 这个 package 提供的 testWidgets() 函数定义一个测试。 testWidgets 函数可以定义一个 widget 测试并创建一个可以使用的 WidgetTester。

在这个示例中，我们将创建一个显示标题“T”和信息“M”的 MyWidget 示例。

我们的测试会验证 MyWidget 是否显示给定的文本

使用 WidgetTester 建立 Widget

下一步，为了在测试环境中建立 MyWidget，我们可以使用 WidgetTester 提供的 pumpWidget()方法，pumpWidget 方法会建立并渲染我们提供的 widget。

在这个示例中，我们将创建一个显内容“T”的 MyWidget 示例。

pump() 方法相关提示

初次调用 pumpWidget() 之后，WidgetTester 会提供其他方式来重建相同的 widget。这对使用 StatefulWidget 或者动画会非常有用。

例如，如果我们点击调用 setState() 的按钮，在测试环境中，Flutter 并不会自动重建你的 widget。我们需要用以下列举的方法来让 Flutter 再一次建立我们的 widget。

tester.pump(Duration duration)

调度一帧以触发 widget 的重建。若指定了 Duration，那么则会让 clock 经过该时长之后调度一帧。它并不会因为持续时间大于一帧的时间而调度多帧。

tester.pumpAndSettle()

在给定期间内不断重复调用 pump 直到完成所有绘制帧。一般需要等到所有动画全部完成。

这些方法在构建周期中保证细粒度控制，这在测试中非常有用。

使用 Finder 查找 widget

现在让我们在测试环境中建立 widget。我们需要用 Finder 通过 widget 树来查找 标题 Text widgets，这样可以验证这些 Widgets 是否正确显示。

为了实现这个目的，我们使用 flutter_test 这个 package 提供的顶级 find() 方法来创建我们的 Finders。因为我们要查找的是 Text widgets，所以可以使用 find.text() 方法。

关于 Finder classes 的更多信息，请参阅定位到目标 Widgets 章节。

使用 Matcher 验证 widget 是否正常工作

最后，让我们来用 flutter_test 提供的 Matcher 常量验证 Text widgets 显示的标题。Matcher 类是 test 包里的核心部分，它提供一种通用方法来验证给定值是否符合我们的预期。

在这个示例中，我们要确保 widget 只在屏幕中出现一次。因此，可以使用 findsOneWidget Matcher。

其他的 Matchers

除了 findsOneWidget，flutter_test 还为常见情况提供了其他的 matchers。

findsNothing

验证没有可被查找的 widgets。

findsWidgets

验证一个或多个 widgets 被找到。

findsNWidgets

验证特定数量的 widgets 被找到。

matchesGoldenFile

验证渲染的 widget 是否与特定的图像匹配（「目标文件」测试）。