Тестирование Flutter

В этом разделе будут представлены три типа тестирования во Flutter: модульные тесты, тесты виджетов и интеграционные тесты.


Обзор типов тестов

TypeОписаниеЗапуск команд
Модульное тестированиеТестирование отдельных функций и методов классовflutter test
Тестирование виджетовТестирование пользовательского интерфейса одного виджетаflutter test
Интеграционное тестированиеТестирование полного потока приложенияflutter test integration_test/

Модульное тестирование

Модульные тесты используются для тестирования кода бизнес-логики.

Пример: Пример модульного теста

// math_utils.dart - код для тестирования
class MathUtils {
  static int add(int a, int b) => a + b;
  static int subtract(int a, int b) => a - b;
  static int multiply(int a, int b) => a * b;
  static double divide(int a, int b) {
    if (b == 0) throw ArgumentError(Нельзя делить на ноль);
    return a / b;
  }

  static int factorial(int n) {
    if (n < 0) throw ArgumentError(Факториал отрицательных чисел не определён);
    if (n == 0 || n == 1) return 1;
    return n * factorial(n - 1);
  }
}

// math_utils_test.dart - тестовый файл
import 'package:flutter_test/flutter_test.dart';
import 'package:my_app/math_utils.dart';

void main() {
  group('MathUtils', () {
    test(add складывает два числа, () {
      expect(MathUtils.add(2, 3), equals(5));
    });

    test(subtract вычитает два числа, () {
      expect(MathUtils.subtract(5, 3), equals(2));
    });

    test(multiply умножает два числа, () {
      expect(MathUtils.multiply(4, 5), equals(20));
    });

    test(divide делит два числа, () {
      expect(MathUtils.divide(10, 2), equals(5));
    });

    test(divide выбрасывает исключение при делении на ноль, () {
      expect(() => MathUtils.divide(10, 0), throwsArgumentError);
    });

    test(factorial вычисляет факториал, () {
      expect(MathUtils.factorial(5), equals(120));
      expect(MathUtils.factorial(0), equals(1));
    });

    test(factorial выбрасывает исключение для отрицательных чисел, () {
      expect(() => MathUtils.factorial(-1), throwsArgumentError);
    });
  });
}

Тестирование виджетов

Widget-тесты используются для тестирования компонентов UI.

Пример: Widget-тест

// counter_widget.dart - тестируемый Widget
class CounterWidget extends StatefulWidget {
  const CounterWidget({super.key});

  @override
  State<CounterWidget> createState() => _CounterWidgetState();
}

class _CounterWidgetState extends State<CounterWidget> {
  int _count = 0;

  void _increment() {
    setState(() {
      _count++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Column(
      mainAxisSize: MainAxisSize.min,
      children: [
        Text(Количество: $_count, key: const Key('counter_text')),
        ElevatedButton(
          key: const Key('increment_button'),
          onPressed: _increment,
          child: const Text('Увеличить'),
        ),
      ],
    );
  }
}

// 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(CounterWidget отображает начальное значение счетчика, (WidgetTester tester) async {
    // Собрать виджет
    await tester.pumpWidget(const MaterialApp(
      home: CounterWidget(),
    ));

    // Проверить отображение начального значения счетчика
    expect(find.text(Count: 0), findsOneWidget);
  });

  testWidgets(CounterWidget увеличивает значение счетчика при нажатии кнопки, (WidgetTester tester) async {
    await tester.pumpWidget(const MaterialApp(
      home: CounterWidget(),
    ));

    // Найти и нажать кнопку
    await tester.tap(find.byKey(const Key('increment_button')));
    await tester.pump();

    // Проверить, что количество обновлено
    expect(find.text(Количество: 1), findsOneWidget);

    // Нажмите ещё раз
    await tester.tap(find.byKey(const Key('increment_button')));
    await tester.pump();

    expect(find.text(Количество: 2), findsOneWidget);
  });
}

Интеграционное тестирование

Интеграционные тесты используются для проверки полного потока функциональности приложения.

Пример: интеграционный тест

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

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group(Интеграционный тест приложения, () {
    testWidgets(Тест полного пользовательского сценария, (WidgetTester tester) async {
      // Запуск приложения
      await tester.pumpWidget(const MyApp());
      await tester.pumpAndSettle();

      // Проверка отображения главной страницы
      expect(find.text('Home'), findsOneWidget);

      // Клик для перехода на страницу деталей
      await tester.tap(find.text('Details'));
      await tester.pumpAndSettle();

      // Проверка отображения страницы деталей
      expect(find.text('Detail Page'), findsOneWidget);

      // Нажмите назад
      await tester.tap(find.byIcon(Icons.arrow_back));
      await tester.pumpAndSettle();

      // Проверить возврат на главный экран
      expect(find.text('Home'), findsOneWidget);
    });
  });
}

Хорошее покрытие тестами может улучшить качество кода; рекомендуется писать модульные тесты по крайней мере для основной бизнес-логики.

Другие расширения