You need to enable JavaScript to run this app. Flutter widget测试中Clipboard.setData的Future then回调未触发如何mock
优惠活动
大模型
产品
解决方案
定价
更多

Flutter widget测试中Clipboard.setData的Future then回调未触发如何mock

问题解决

问题根因

Widget测试运行在无原生平台实现的模拟环境中,Clipboard.setData内部依赖flutter/platform通道调用系统剪贴板服务,测试环境默认未注册该通道的响应处理器,导致返回的Future永远处于pending状态,then回调无法触发。

解决方案

直接在测试内模拟剪贴板MethodChannel的返回即可,无需修改原有业务代码。完整可通过的测试代码如下:

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

testWidgets('test clipboard function', (WidgetTester tester) async {
  // 模拟剪贴板通道响应
  TestDefaultBinaryMessenger messenger = tester.binding.defaultBinaryMessenger as TestDefaultBinaryMessenger;
  messenger.setMockMethodCallHandler(SystemChannels.platform, (MethodCall call) async {
    if (call.method == 'Clipboard.setData') {
      // 模拟返回成功,让Future完成
      return null;
    }
    // 其他通道调用保持默认逻辑
    return null;
  });

  var dataCopied = false;
  await tester.pumpWidget(
    MaterialApp(
      home: Container(
        width: 10,
        height: 10,
        child: ElevatedButton(
          onPressed: (() {
            Clipboard.setData(ClipboardData(text: "test")).then((_) {
              dataCopied = true;
            });
          }),
          child: Text("Copy Text"),
        ),
      ),
    ),
  );

  await tester.tap(find.byType(ElevatedButton));
  // 等待微任务队列处理完成
  await tester.pumpAndSettle();
  expect(dataCopied, true);

  // 测试结束后清空mock处理器,避免影响其他测试
  messenger.setMockMethodCallHandler(SystemChannels.platform, null);
});

可选扩展

如果需要验证复制的文本内容是否正确,可以在mock处理器中捕获传入的文本,添加额外校验:

  • 定义变量存储复制的文本:String? copiedText;
  • 在mock处理器中添加取值逻辑:
    if (call.method == 'Clipboard.setData') {
      copiedText = call.arguments['text'] as String;
      return null;
    }
    
  • 测试时增加校验:expect(copiedText, 'test');

内容的提问来源于stack exchange,提问作者Stan

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.10 10:42:02