Flutter中如何测试作为参数传递的函数？及实现模式探讨

一、核心疑问解答 #

• 关于白盒/黑盒测试：当前验证onFailure调用的测试确实属于白盒范畴，但并非不符合规范——因为回调参数是用例对外暴露的约定接口，测试它是在验证用例是否履行了契约，而非窥探内部实现细节。
• 回调参数是否是反模式：不算反模式，但返回Either类型是更贴合Dart/Flutter生态的惯用方案。回调适合需要多次异步通知的场景（如下载进度），但单次结果返回用Either更简洁，也更便于链式调用和测试。
• 是否应该改为返回Either：非常建议重构。Either能明确表达“成功/失败”二选一的结果，符合函数式编程风格，测试时无需依赖回调，直接断言返回值即可，代码可读性和可维护性都会提升。

二、用Mocktail验证回调的临时方案（不重构现有代码） #

如果暂时不想改动用例结构，可以用Mocktail创建回调的Mock对象，验证onFailure的调用情况：

1. 先在pubspec.yaml的dev_dependencies中添加Mocktail依赖：

dev_dependencies:
  mocktail: ^1.0.0

2. 编写测试代码：

import 'package:mocktail/mocktail.dart';
import 'package:test/test.dart';

// 定义回调的Mock类
class MockAuthFailureCallback extends Mock {
  void call(AuthFailure fail);
}

class MockUserSuccessCallback extends Mock {
  void call(User user);
}

void main() {
  late YourUseCase useCase;
  late MockAuthFailureCallback mockOnFailure;
  late MockUserSuccessCallback mockOnSuccess;

  setUp(() {
    useCase = YourUseCase();
    mockOnFailure = MockAuthFailureCallback();
    mockOnSuccess = MockUserSuccessCallback();
    // 注册AuthFailure的 fallback 值（Mocktail需要）
    registerFallbackValue(const AuthFailure.wrongCredentials());
  });

  test('use case - triggers onFailure for invalid credentials', () async {
    // WHEN
    final user = await useCase.execute(
      username: "noname",
      password: "password",
      onFailure: mockOnFailure,
      onSuccess: mockOnSuccess,
    );

    // THEN
    // 验证onFailure被正确调用1次，参数匹配
    verify(() => mockOnFailure(const AuthFailure.wrongCredentials())).called(1);
    // 验证onSuccess从未被调用
    verifyNever(() => mockOnSuccess(any()));
    expect(user, const User.anonymous());
  });
}

三、重构为返回Either的优化方案 #

这是更推荐的长期方案，需要引入dartz库（或自行实现Either类型）：

重构后的用例代码 #

import 'package:dartz/dartz.dart';

Future<Either<AuthFailure, User>> execute({
  required String username,
  required String password,
}) async {
  if (username.isNonValid || password.isNonValid) {
    return left(const AuthFailure.wrongCredentials());
  }
  // 执行正常登录逻辑，成功时返回right包装的User
  final loggedInUser = await _authDataSource.login(username, password);
  return right(loggedInUser);
}

对应的测试代码（更简洁） #

test('use case - returns failure for invalid credentials', () async {
  // WHEN
  final result = await useCase.execute(
    username: "noname",
    password: "password",
  );

  // THEN
  expect(result, left(const AuthFailure.wrongCredentials()));
});

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