Define and generate mock objects for external dependencies using `package:mockito` and `build_runner`. Use when unit testing classes that depend on complex external services like APIs or databases.

Testing and Mocking Dart Applications Contents [Structuring Code for Testability]( structuring code for testability) [Managing Dependencies]( managing dependencies) [Generating Mocks]( generating mocks) [Implementing Unit Tests]( implementing unit tests) [Workflow: Creating and Running Mocked Tests]( workflow creating and running mocked tests) [Examples]( examples) Structuring Code for Testability Design Dart classes to support dependency injection. Isolate complex external dependencies (like API clients or databases) so they can be replaced with mock objects during testing. Inject external services (e.g., http.Client ) through class constructors. Represent URLs strictly as Uri objects using Uri.parse(string) . Utilize Dart's object oriented features (classes, mixins) to define clear interfaces for external interactions. Managing Dependencies Configure the pubspec.yaml file with the necessary testing and code generation packages. Add runtime dependencies (e.g., package:http ) using dart pub add http . Add testing dependencies using dart pub add dev:test dev:mockito dev:build runner . Import HTTP libraries with a prefix to avoid namespace collisions: import 'package:http/http.dart' as http; . Generating Mocks Use package:mockito and build runner to automatically generate mock classes for fixed scenarios and behavior verification. Always use the @GenerateNiceMocks annotation (preferable to @GenerateMocks to avoid missing stub exceptions). Place the annotation in the test file, passing a list of MockSpec<Type () objects. Import the generated file using the .mocks.dart extension. Execute build runner to generate the mock files: dart run build runner build . Implementing Unit Tests Isolate the system under test using the generated mock objects. Use package:test to structure the test suite. Stubbing: Configure mock behavior before interacting with the system under test. Use when(mock.method()).thenReturn(value) for synchronous methods. CRITICAL: Always use thenAnswer(( ) async = value) for methods returning a Future or Stream . Never use thenReturn for asynchronous returns. Verification: Assert that the system under test interacted with the mock object correctly. Use verify(mock.method()).called(1) to check exact invocation counts. Use argument matchers like any , anyNamed , or captureAny for flexible verification. Workflow: Creating and Running Mocked Tests Use the following checklist to implement and verify mocked unit tests. Task Progress [ ] 1. Identify the external dependency to mock (e.g., http.Client ). [ ] 2. Inject the dependency into the target class constructor. [ ] 3. Create a test file (e.g., target test.dart ) and add @GenerateNiceMocks([MockSpec<Dependency ()]) . [ ] 4. Add the part or import directive for the generated .mocks.dart file. [ ] 5. Run dart run build runner build to generate the mock classes. [ ] 6. Write the test cases using group() and test() . [ ] 7. Stub required behaviors using when() . [ ] 8. Execute the target method. [ ] 9. Verify interactions using verify() and assert outcomes using expect() . [ ] 10. Run the test suite using dart test . Feedback Loop: Test Failures If tests fail or build runner encounters errors: 1. Run validator: Execute dart test or dart run build runner build . 2. Review errors: Check for missing stubs, mismatched argument matchers, or syntax errors in the generated files. 3. Fix: If a mock method throws an unexpected null error, ensure you used @GenerateNiceMocks . If an async stub throws an ArgumentError , change thenReturn to thenAnswer . If build runner fails, ensure the .mocks.dart import matches the file name exactly. 4. Repeat until all tests pass. Examples High Fidelity Mocking and Testing Example 1. System Under Test ( lib/api service.dart ) 2. Test Implementation ( test/api service test.dart )

dart-generate-test-mocks