Flutter集成测试中如何检测Toast消息？

Toast的实现方式不同，测试方法也不一样，分三种常见情况给你解决办法：

1. 用Flutter原生SnackBar模拟Toast #

很多开发者会用SnackBar替代Toast，这种情况最容易测试——它属于Flutter Widget树的一部分：

• 触发Toast显示后，必须等待动画完成，用pumpAndSettle()而非单纯的固定延迟
• 直接用find.text()或find.byType(SnackBar)查找目标内容

示例代码：

testWidgets('测试SnackBar类型的Toast', (tester) async {
  await tester.pumpWidget(const MyApp());

  // 点击触发Toast的按钮
  await tester.tap(find.byKey(const Key('show_toast_btn')));
  // 等待SnackBar的显示动画完成
  await tester.pumpAndSettle();

  // 验证Toast内容是否存在
  expect(find.text('操作成功！'), findsOneWidget);
});

2. 使用第三方库（如fluttertoast）的原生Toast #

这类Toast调用的是原生系统Toast，不在Flutter的Widget树里，find.byText()肯定找不到。可以通过拦截MethodChannel调用来验证Toast是否被正确触发：

示例代码：

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

void main() {
  // 对应fluttertoast的MethodChannel名称
  const toastChannel = MethodChannel('PonnamKarthik/fluttertoast');
  String? capturedToastMsg;

  setUp(() {
    // 设置Mock Handler捕获Toast调用
    toastChannel.setMockMethodCallHandler((call) async {
      if (call.method == 'showToast') {
        // 提取Toast的消息内容
        capturedToastMsg = call.arguments['msg'];
      }
      return null;
    });
  });

  tearDown(() {
    // 清理Mock
    toastChannel.setMockMethodCallHandler(null);
    capturedToastMsg = null;
  });

  testWidgets('测试第三方库原生Toast', (tester) async {
    await tester.pumpWidget(const MyApp());

    // 触发Toast显示
    await tester.tap(find.byKey(const Key('show_native_toast')));
    // 给点时间让MethodChannel调用完成
    await Future.delayed(const Duration(milliseconds: 300));

    // 验证捕获到的消息是否正确
    expect(capturedToastMsg, '原生Toast已显示');
  });
}

3. 自定义Toast组件（基于Overlay实现） #

如果是自己封装的Overlay Toast，需要确保它被插入到Widget树后再查找：

• 用waitFor()方法等待Toast出现（比固定延迟更可靠）
• 直接用find.text()查找内容

示例代码：

testWidgets('测试自定义Overlay Toast', (tester) async {
  await tester.pumpWidget(const MyApp());

  // 触发自定义Toast
  await tester.tap(find.byKey(const Key('show_custom_toast')));
  
  // 等待Toast出现在Widget树中，超时时间2秒
  await tester.waitFor(find.text('自定义Toast内容'), timeout: const Duration(seconds: 2));
  
  // 验证Toast存在
  expect(find.text('自定义Toast内容'), findsOneWidget);
});

常见坑点提醒 #

• 不要用固定延迟代替pumpAndSettle()或waitFor()：固定延迟不可靠，不同设备动画时长有差异
• 原生Toast别用Flutter的查找方法：不在Widget树里，肯定找不到，必须用MethodChannel拦截
• 如果Toast显示时间极短：可以临时修改测试环境下的Toast显示时长（比如设为5秒），避免还没捕获就消失

内容的提问来源于stack exchange，提问作者MDias