从新手到专家：Mockito for Dart测试场景全攻略

【免费下载链接】mockitoMockito-inspired mock library for Dart项目地址: https://gitcode.com/gh_mirrors/moc/mockito

Mockito for Dart是一款受Mockito启发的Dart模拟库，专为简化Dart应用的单元测试而设计。无论是新手开发者还是资深工程师，都能通过它轻松创建模拟对象、验证方法调用并模拟返回值，显著提升测试效率与代码质量。

📚 核心功能快速掌握

1. 模拟对象创建

通过mock()函数可快速生成任意类的模拟实例，无需手动实现接口方法：

final mockClient = mock<HttpClient>();

在lib/src/mock.dart中定义了核心模拟逻辑，支持动态生成模拟方法。

2. 方法调用验证

使用verify()函数检查模拟对象的方法是否按预期调用：

verify(mockClient.get(Uri.parse('https://example.com'))).called(1);

验证逻辑在test/verify_test.dart中有详细测试用例。

3. 模拟返回值设置

通过when()API配置方法调用的返回值或异常：

when(mockClient.get(any)).thenAnswer((_) async => http.Response('OK', 200));

相关实现可参考lib/src/invocation_matcher.dart。

🔍 实用测试场景解析

网络请求模拟

在测试网络相关代码时，可模拟HttpClient实现无网络环境测试：

final mockClient = mock<HttpClient>(); when(mockClient.send(any)).thenThrow(HttpException('Network error'));

test/end2end/generated_mocks_test.dart包含完整的端到端测试示例。

异步方法测试

针对Future和Stream类型的异步方法，提供专门的处理机制：

when(mockRepository.fetchData()).thenAnswer((_) async => ['item1', 'item2']);

异步测试支持在lib/src/call_pair.dart中实现。

参数匹配器使用

内置多种参数匹配器，简化复杂参数的验证逻辑：

verify(mockLogger.log(any, contains('error'))).called(atLeastOnce);

完整的匹配器列表可在lib/src/invocation_matcher.dart中查看。

🚀 进阶技巧与最佳实践

1. 自动生成模拟类

通过构建器自动生成类型安全的模拟类，提升开发效率：

// build.yaml配置示例 targets: $default: builders: mockito|mockBuilder: enabled: true

构建器实现位于lib/src/builder.dart。

2. 行为验证与状态验证

区分方法调用验证（行为）和结果验证（状态）的使用场景：

// 行为验证 verify(mockService.notifyListeners()).called(1); // 状态验证 expect(service.state, equals(ServiceState.loaded));

验证策略在test/mockito_test.dart中有对比演示。

3. 清理测试环境

使用reset()方法重置模拟对象状态，避免测试间相互干扰：

reset(mockClient);

重置功能实现在lib/src/mock.dart中。

📦 快速开始指南

安装依赖

在pubspec.yaml中添加依赖：

dev_dependencies: mockito: ^5.4.0 build_runner: ^2.4.0

生成模拟类

运行构建命令生成模拟代码：

dart run build_runner build

编写第一个测试

创建测试文件example_test.dart：

import 'package:mockito/mockito.dart'; import 'package:test/test.dart'; class MockCalculator extends Mock implements Calculator {} void main() { late MockCalculator calculator; setUp(() { calculator = MockCalculator(); }); test('adds two numbers', () { when(calculator.add(2, 3)).thenReturn(5); expect(calculator.add(2, 3), equals(5)); verify(calculator.add(2, 3)).called(1); }); }

📖 深入学习资源

• 官方文档：README.md
• 升级指南：upgrading-to-mockito-3.md
• 常见问题：FAQ.md
• 测试示例：test/目录下包含完整测试用例集合

通过本指南，您已掌握Mockito for Dart的核心用法与高级技巧。无论是单元测试、集成测试还是TDD开发，Mockito都能成为您的得力助手，帮助构建更健壮、更可维护的Dart应用。开始使用Mockito，让测试变得简单而高效！

【免费下载链接】mockitoMockito-inspired mock library for Dart项目地址: https://gitcode.com/gh_mirrors/moc/mockito