Integration testing in Flutter

Introduction

Integration testing checks if different parts of your app work well together. It helps find problems that unit tests might miss.

When you want to test if the login screen works with the backend service.

When you need to check if navigation between pages happens correctly.

When you want to verify that user input updates the UI as expected.

When you want to test the app's behavior on a real device or emulator.

When you want to catch bugs that appear only when multiple widgets interact.

Syntax

Flutter

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

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('test description', (WidgetTester tester) async {
    // Build app
    await tester.pumpWidget(MyApp());

    // Interact with widgets
    await tester.tap(find.text('Login'));
    await tester.pumpAndSettle();

    // Verify results
    expect(find.text('Welcome'), findsOneWidget);
  });
}

Use IntegrationTestWidgetsFlutterBinding.ensureInitialized() to set up integration testing.

Use testWidgets to write tests that interact with the UI.

Examples

This test taps a button and checks if the text 'Button tapped' appears.

Flutter

IntegrationTestWidgetsFlutterBinding.ensureInitialized();

testWidgets('tap button shows text', (tester) async {
  await tester.pumpWidget(MyApp());
  await tester.tap(find.byType(ElevatedButton));
  await tester.pumpAndSettle();
  expect(find.text('Button tapped'), findsOneWidget);
});

This test taps a 'Next' button and verifies navigation to the second page.

Flutter

IntegrationTestWidgetsFlutterBinding.ensureInitialized();

testWidgets('navigate to next page', (tester) async {
  await tester.pumpWidget(MyApp());
  await tester.tap(find.text('Next'));
  await tester.pumpAndSettle();
  expect(find.text('Second Page'), findsOneWidget);
});

Sample App

This integration test runs the app with a login button. When the button is tapped, it shows a welcome message. The test checks this behavior.

Flutter

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('login button shows welcome message', (WidgetTester tester) async {
    await tester.pumpWidget(MaterialApp(
      home: Scaffold(
        body: LoginScreen(),
      ),
    ));

    expect(find.text('Welcome'), findsNothing);

    await tester.tap(find.text('Login'));
    await tester.pumpAndSettle();

    expect(find.text('Welcome'), findsOneWidget);
  });
}

class LoginScreen extends StatefulWidget {
  @override
  State<LoginScreen> createState() => _LoginScreenState();
}

class _LoginScreenState extends State<LoginScreen> {
  bool loggedIn = false;

  @override
  Widget build(BuildContext context) {
    return Center(
      child: loggedIn
          ? Text('Welcome')
          : ElevatedButton(
              onPressed: () {
                setState(() {
                  loggedIn = true;
                });
              },
              child: Text('Login'),
            ),
    );
  }
}

Important Notes

Integration tests run slower than unit tests because they start the app and interact with the UI.

Use pumpAndSettle() to wait for animations and UI updates to finish.

Run integration tests on real devices or emulators for best results.

Summary

Integration testing checks if app parts work together correctly.

Use IntegrationTestWidgetsFlutterBinding.ensureInitialized() to set up.

Write tests that tap, type, and check UI changes.

Practice

1. What is the main purpose of integration testing in Flutter apps?

easy

A. To test individual functions for correctness

B. To check the app's UI design colors

C. To measure app performance under load

D. To check if different parts of the app work together correctly

Solution

1. Step 1: Understand integration testing goal

   Integration testing focuses on how different parts of the app interact and work together.

2. Step 2: Compare with other test types

   Unit tests check individual functions, performance tests check speed, and UI design tests check visuals.

3. Final Answer:

   To check if different parts of the app work together correctly -> Option D

4. Quick Check:

   Integration testing = check parts working together [OK]

Hint: Integration tests check combined parts, not single functions [OK]

Common Mistakes:

• Confusing integration testing with unit testing
• Thinking it tests only UI colors
• Mixing it up with performance testing

2. Which line correctly initializes integration testing in a Flutter test file?

easy

A. IntegrationTestWidgetsFlutterBinding.ensureInitialized();

B. WidgetsFlutterBinding.ensureInitialized();

C. IntegrationTestBinding.initialize();

D. TestWidgetsBinding.ensureInitialized();

Solution

1. Step 1: Identify the correct binding for integration tests

   The official Flutter integration test package uses IntegrationTestWidgetsFlutterBinding.ensureInitialized() to set up.

2. Step 2: Check other options for correctness

   WidgetsFlutterBinding is for widget tests, not integration tests. Others are incorrect or do not exist.

3. Final Answer:

   IntegrationTestWidgetsFlutterBinding.ensureInitialized(); -> Option A

4. Quick Check:

   Use IntegrationTestWidgetsFlutterBinding for integration tests [OK]

Hint: Use IntegrationTestWidgetsFlutterBinding.ensureInitialized() for integration tests [OK]

Common Mistakes:

• Using WidgetsFlutterBinding instead of IntegrationTestWidgetsFlutterBinding
• Misspelling the method name
• Trying to call a non-existent initialize() method

3. Given this integration test snippet, what will the test check?

final button = find.text('Tap me');
await tester.tap(button);
await tester.pumpAndSettle();
expect(find.text('Tapped!'), findsOneWidget);

medium

A. The test checks if the button is disabled

B. The button labeled 'Tapped!' is tapped and text changes to 'Tap me'

C. The button labeled 'Tap me' is tapped and text changes to 'Tapped!'

D. The test waits but does not tap any button

Solution

1. Step 1: Analyze the tap action

   The test finds a button with text 'Tap me' and taps it.

2. Step 2: Check the expected result

   After tapping and waiting for animations, it expects to find text 'Tapped!' on screen.

3. Final Answer:

   The button labeled 'Tap me' is tapped and text changes to 'Tapped!' -> Option C

4. Quick Check:

   Tap 'Tap me' button, expect 'Tapped!' text [OK]

Hint: Look for tap target text and expected text after tap [OK]

Common Mistakes:

• Confusing which text is tapped and which is expected
• Ignoring await pumpAndSettle() for UI update
• Assuming no tap happens

4. What is wrong with this integration test code snippet?

void main() {
  testWidgets('tap test', (tester) async {
    final binding = IntegrationTestWidgetsFlutterBinding.ensureInitialized();
    final button = find.text('Click');
    await tester.tap(button);
    expect(find.text('Clicked'), findsOneWidget);
  });
}

medium

A. Binding initialization should be outside testWidgets, in main() before tests

B. The find.text selector is incorrect syntax

C. Missing await before tester.tap

D. expect should be called before tap

Solution

1. Step 1: Check binding initialization placement

   IntegrationTestWidgetsFlutterBinding.ensureInitialized() should be called once before all tests, not inside testWidgets.

2. Step 2: Verify other code parts

   find.text syntax is correct, await is used before tap, and expect is correctly after tap.

3. Final Answer:

   Binding initialization should be outside testWidgets, in main() before tests -> Option A

4. Quick Check:

   Initialize binding once before tests [OK]

Hint: Initialize binding once before tests, not inside each test [OK]

Common Mistakes:

• Calling ensureInitialized inside each testWidgets
• Forgetting await before tap
• Misordering expect before tap

5. You want to write an integration test that types 'hello' into a TextField and then taps a button labeled 'Send'. Which sequence correctly performs this in Flutter integration tests?

hard

A. await tester.tap(find.text('Send')); await tester.enterText(find.byType(TextField), 'hello'); await tester.pump();

B. await tester.enterText(find.byType(TextField), 'hello'); await tester.tap(find.text('Send')); await tester.pumpAndSettle();

C. await tester.enterText(find.text('Send'), 'hello'); await tester.tap(find.byType(TextField)); await tester.pumpAndSettle();

D. await tester.tap(find.byType(TextField)); await tester.enterText(find.text('Send'), 'hello'); await tester.pump();

Solution

1. Step 1: Enter text into the TextField

   Use tester.enterText with find.byType(TextField) to type 'hello'.

2. Step 2: Tap the 'Send' button and wait for UI update

   Tap the button found by text 'Send' and call pumpAndSettle() to wait for animations.

3. Final Answer:

   await tester.enterText(find.byType(TextField), 'hello'); await tester.tap(find.text('Send')); await tester.pumpAndSettle(); -> Option B

4. Quick Check:

   Type first, then tap button, then wait [OK]

Hint: Type text first, then tap button, then wait for UI [OK]

Common Mistakes:

• Tapping button before typing text
• Using wrong finder for TextField or button
• Not waiting with pumpAndSettle after tap