Flutter Testing Your App

Testing confirms that your code works correctly — now and after future changes. Flutter supports three types of tests: unit tests for logic, widget tests for UI components, and integration tests for full app flows.

Why Test

  Without tests:
  ──────────────────────────────────────────────
  You change code in File A
  → Something breaks in File B
  → You find out after users complain

  With tests:
  ──────────────────────────────────────────────
  You change code in File A
  → Tests run automatically
  → Test fails immediately → You fix it before release

Three Types of Flutter Tests

  ┌─────────────────┬────────────────────────────────────┬──────────┐
  │ Type            │ Tests                              │ Speed    │
  ├─────────────────┼────────────────────────────────────┼──────────┤
  │ Unit Test       │ Single functions or classes        │ Fastest  │
  │ Widget Test     │ Individual widgets in isolation    │ Fast     │
  │ Integration Test│ Full app flow on real/emulator     │ Slowest  │
  └─────────────────┴────────────────────────────────────┴──────────┘

Project Test Structure

  my_app/
  ├── lib/
  │   ├── main.dart
  │   └── cart_service.dart
  ├── test/
  │   ├── cart_service_test.dart   ← unit tests
  │   └── cart_widget_test.dart    ← widget tests
  └── integration_test/
      └── app_test.dart            ← integration tests

Unit Testing

Unit tests check a single function or class with no UI. They run very fast — hundreds per second.

The Code to Test

// lib/cart_service.dart
class CartService {
  List<String> _items = [];

  void addItem(String item) {
    if (item.isNotEmpty) _items.add(item);
  }

  void removeItem(String item) => _items.remove(item);
  int get count => _items.length;
  double get total => count * 100.0;  // Simplified
  void clear() => _items.clear();
}

Writing Unit Tests

// test/cart_service_test.dart
import 'package:flutter_test/flutter_test.dart';
import 'package:my_app/cart_service.dart';

void main() {
  group('CartService', () {

    test('starts with zero items', () {
      final cart = CartService();
      expect(cart.count, equals(0));
    });

    test('adds an item correctly', () {
      final cart = CartService();
      cart.addItem('Shoes');
      expect(cart.count, equals(1));
    });

    test('ignores empty string items', () {
      final cart = CartService();
      cart.addItem('');
      expect(cart.count, equals(0));
    });

    test('removes an item correctly', () {
      final cart = CartService();
      cart.addItem('Shoes');
      cart.removeItem('Shoes');
      expect(cart.count, equals(0));
    });

    test('calculates total correctly', () {
      final cart = CartService();
      cart.addItem('Shoes');
      cart.addItem('Shirt');
      expect(cart.total, equals(200.0));
    });

  });
}

Run Unit Tests

flutter test test/cart_service_test.dart

# Output:
# 00:01 +5: All tests passed!

Test Anatomy

  group('CartService', () {    ← Groups related tests together
    test('description', () {  ← One test case
      // Arrange — set up
      final cart = CartService();
      cart.addItem('Shoes');

      // Act — do the thing
      cart.removeItem('Shoes');

      // Assert — check the result
      expect(cart.count, equals(0));
    });
  });

Common Matchers

expect(value, equals(5));          // value == 5
expect(value, isNull);             // value is null
expect(value, isNotNull);          // value is not null
expect(value, isTrue);             // value is true
expect(value, isFalse);            // value is false
expect(list, contains('Apple'));   // list contains item
expect(list, isEmpty);             // list is empty
expect(list, hasLength(3));        // list has 3 items
expect(value, greaterThan(0));     // value > 0
expect(fn, throwsException);       // function throws

Widget Testing

Widget tests render a widget in a fake environment and verify what appears on screen.

// test/counter_widget_test.dart
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:my_app/counter_widget.dart';

void main() {
  testWidgets('counter increments on button tap', (WidgetTester tester) async {
    // Render the widget
    await tester.pumpWidget(MaterialApp(home: CounterWidget()));

    // Verify initial state
    expect(find.text('Count: 0'), findsOneWidget);

    // Tap the increment button
    await tester.tap(find.byIcon(Icons.add));
    await tester.pump();  // Rebuild the widget

    // Verify updated state
    expect(find.text('Count: 1'), findsOneWidget);
  });
}

Common WidgetTester Methods

Running All Tests

flutter test           # Run all tests in /test folder
flutter test --coverage  # Generate code coverage report

Testing Best Practices

• Write tests as you build features — not after the app is complete.
• Each test checks one specific behavior.
• Use descriptive test names so failures are easy to understand.
• Aim for high coverage on business logic (CartService, AuthService, etc.).
• Mock external dependencies (APIs, Firebase) in unit tests using packages like mockito.