Mock dependencies in Flutter

Introduction

Mock dependencies help you test parts of your app without using real services. This makes testing faster and safer.

When you want to test a widget that uses a service like a database or API without calling the real service.

When you want to check how your app behaves if a service returns certain data or errors.

When you want to run tests offline without internet access.

When you want to isolate a part of your app to find bugs easily.

Syntax

Flutter

import 'package:mocktail/mocktail.dart';

class MockService extends Mock implements RealService {}

void main() {
  final mockService = MockService();
  when(() => mockService.getData()).thenReturn('mock data');
}

Use the mocktail package in Flutter to create mocks easily.

The when function sets what the mock should return when called.

Examples

This example mocks an API service to return a test user asynchronously.

Flutter

import 'package:mocktail/mocktail.dart';

class MockApi extends Mock implements ApiService {}

final mockApi = MockApi();
when(() => mockApi.fetchUser()).thenAnswer((_) async => User(name: 'Test'));

This example mocks a database to return a list of items instantly.

Flutter

import 'package:mocktail/mocktail.dart';

class MockDatabase extends Mock implements Database {}

final mockDb = MockDatabase();
when(() => mockDb.getItems()).thenReturn(['item1', 'item2']);

Sample App

This test shows how to replace a real API call with a mock that returns 'mock data'. It helps test without calling the real API.

Flutter

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

class ApiService {
  String fetchData() => 'real data';
}

class MockApiService extends Mock implements ApiService {}

void main() {
  test('MockApiService returns mock data', () {
    final mockApi = MockApiService();
    when(() => mockApi.fetchData()).thenReturn('mock data');

    final result = mockApi.fetchData();
    expect(result, 'mock data');
  });
}

Important Notes

Always register fallback values if your mock methods use arguments.

Mocks do not run real code, so they are fast and safe for tests.

Use mocks to simulate errors and test how your app handles them.

Summary

Mocks replace real services in tests to control behavior.

Use the mocktail package to create mocks in Flutter.

Mocks help test your app faster and more reliably.

Practice

1. What is the main purpose of using mocks in Flutter testing?

easy

A. To write less code in the app

B. To speed up the app in production

C. To create UI components faster

D. To replace real services and control their behavior during tests

Solution

1. Step 1: Understand what mocks do

   Mocks replace real services or dependencies in tests to simulate their behavior.

2. Step 2: Identify the purpose in testing

   This helps tests run faster and more reliably by controlling external factors.

3. Final Answer:

   To replace real services and control their behavior during tests -> Option D

4. Quick Check:

   Mocks replace services = A [OK]

Hint: Mocks simulate services in tests to control behavior [OK]

Common Mistakes:

• Thinking mocks speed up production app
• Confusing mocks with UI widgets
• Believing mocks reduce app code size

2. Which of the following is the correct way to create a mock class using the mocktail package in Flutter?

easy

A. class MockService extends Service implements Mock {}

B. class MockService extends Mock implements Service {}

C. class MockService with Mock implements Service {}

D. class MockService implements Mock, Service {}

Solution

1. Step 1: Recall mocktail syntax

   In mocktail, a mock class extends Mock and implements the interface to mock.

2. Step 2: Match syntax to options

   class MockService extends Mock implements Service {} correctly extends Mock and implements Service.

3. Final Answer:

   class MockService extends Mock implements Service {} -> Option B

4. Quick Check:

   Extend Mock, implement interface = A [OK]

Hint: Mock classes extend Mock and implement the target interface [OK]

Common Mistakes:

• Swapping extends and implements order
• Using with instead of extends
• Not implementing the interface

3. Given the following code snippet using mocktail, what will be the output of print(service.getData())?

class MockService extends Mock implements Service {}

final service = MockService();
when(() => service.getData()).thenReturn('Mocked Data');
print(service.getData());

medium

A. Returns 'Mocked Data'

B. Throws an error because getData is not defined

C. Returns null

D. Returns the real data from Service

Solution

1. Step 1: Understand when-thenReturn usage

   The when() function sets up the mock to return 'Mocked Data' when getData() is called.

2. Step 2: Check the print statement

   Calling service.getData() returns the mocked value 'Mocked Data'.

3. Final Answer:

   Returns 'Mocked Data' -> Option A

4. Quick Check:

   when().thenReturn() sets output = B [OK]

Hint: when().thenReturn() sets mock return value [OK]

Common Mistakes:

• Expecting real method call instead of mock
• Thinking it returns null by default
• Confusing syntax causing runtime error

4. Identify the error in this mocktail test setup:

class MockService extends Mock implements Service {}

final service = MockService();
when(service.getData()).thenReturn('Data');

medium

A. Missing parentheses in when() argument

B. MockService should not implement Service

C. Incorrect use of when() without a lambda function

D. thenReturn() cannot return a string

Solution

1. Step 1: Check when() syntax

   when() requires a lambda function like () => service.getData(), not a direct call.

2. Step 2: Identify the error

   Passing service.getData() calls the method immediately, causing error.

3. Final Answer:

   Incorrect use of when() without a lambda function -> Option C

4. Quick Check:

   when() needs lambda = C [OK]

Hint: Use () => method() inside when() [OK]

Common Mistakes:

• Calling method directly inside when()
• Forgetting to implement interface
• Misusing thenReturn() with wrong types

5. You want to test a Flutter widget that depends on a service fetching user data. How do mocks help in this scenario?

hard

A. Mocks allow you to simulate user data responses without real network calls

B. Mocks automatically generate UI for the widget

C. Mocks replace the widget with a simpler version

D. Mocks speed up the app by caching data

Solution

1. Step 1: Understand widget dependency on service

   The widget depends on a service that fetches user data, usually from network.

2. Step 2: Role of mocks in testing

   Mocks simulate the service to provide controlled user data without real network calls.

3. Step 3: Benefits in testing

   This makes tests faster, reliable, and independent of external systems.

4. Final Answer:

   Mocks allow you to simulate user data responses without real network calls -> Option A

5. Quick Check:

   Mocks simulate data, no real calls = D [OK]

Hint: Mocks simulate service data to avoid real network calls [OK]

Common Mistakes:

• Thinking mocks generate UI automatically
• Confusing mocks with widget replacements
• Believing mocks cache data for performance