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

Модульное тестирование — фундаментальное средство обеспечения качества кода.

Оно проверяет, соответствует ли поведение каждой наименьшей функциональной единицы (обычно функции или метода) ожиданиям.

В этой главе рассказывается об использовании пакета test в Dart, написании тестовых случаев с помощью test(), утверждений с помощью expect() и группировке тестов с помощью group().


Установка и настройка пакета test

Dart официально предоставляет пакет test для написания и запуска тестов.

Сначала добавьте зависимость в pubspec.yaml:

# 文件路径:pubspec.yaml
dev_dependencies:
  test: ^1.24.0

Затем выполните следующую команду для установки:

$ dart pub get

Тестовые файлы обычно размещаются в каталоге test/ проекта, а имена файлов заканчиваются на _test.dart.

Типичная структура проекта:

my_project/
├── lib/
│   └── calculator.dart       # 被测试的代码
├── test/
│   └── calculator_test.dart  # 测试文件
└── pubspec.yaml

Написание тестовых случаев с test()

Функция test() — базовая единица для написания тестовых случаев.

Она принимает два параметра: описание теста (строка) и тело тестовой функции.

Пример

Тестируемый код (lib/calculator.dart):

// Путь к файлу: lib/calculator.dart
class Calculator {
  int add(int a, int b) => a + b;
  int subtract(int a, int b) => a - b;
  int multiply(int a, int b) => a * b;

  double divide(int a, int b) {
    if (b == 0) {
      throw ArgumentError(Делитель не может быть 0);
    }
    return a / b;
  }

  bool isEven(int n) => n % 2 == 0;

  List<int> filterPositive(List<int> numbers) {
    return numbers.where((n) => n > 0).toList();
  }
}

Пример

Тестовый файл (test/calculator_test.dart):

// Путь к файлу: test/calculator_test.dart
import 'package:test/test.dart';
import 'package:my_project/calculator.dart';

void main() {
  // Создать экземпляр Calculator для тестирования
  var calculator = Calculator();

  // функция test(): первый параметр — описание теста, второй — тестовая функция
  test('add() складывает два положительных числа', () {
    var result = calculator.add(3, 5);
    // утверждение expect(): проверяет, равен ли фактический результат ожидаемому значению
    expect(result, equals(8));
  });

  test('add() добавляет отрицательные числа', () {
    expect(calculator.add(-3, 5), equals(2));
    expect(calculator.add(-3, -5), equals(-8));
  });

  test('subtract() операция вычитания', () {
    expect(calculator.subtract(10, 3), equals(7));
  });

  test('multiply() операция умножения', () {
    expect(calculator.multiply(4, 5), equals(20));
    // Умножение на ноль
    expect(calculator.multiply(100, 0), equals(0));
  });

  test(divide() обычное деление, () {
    expect(calculator.divide(10, 2), equals(5.0));
    expect(calculator.divide(7, 2), equals(3.5));
  });

  test(isEven() проверка чётного числа, () {
    expect(calculator.isEven(4), isTrue);
    expect(calculator.isEven(5), isFalse);
  });
}

Запуск тестов:

$ dart test
00:00 +6: All tests passed!

Утверждения expect

expect() — ключевая функция в тестировании; она проверяет, удовлетворяет ли фактическое значение условию.

Базовый синтаксис: expect(actual, matcher).

Распространённые матчеры

МатчерНазначениеПример
equals(expected)Проверяет, что значения равныexpect(result, equals(42))
isTrue / isFalseПроверяет логические значенияexpect(flag, isTrue)
isNull / isNotNullПроверить nullexpect(value, isNull)
contains(value)Содержит элемент (список) или подстроку (строку).expect(list, contains('a'))
isA()Проверить типыexpect(obj, isA())
throws()Проверить, что исключение выброшеноexpect(() => f(), throwsException)
isNotEmptyне nullexpect(list, isNotEmpty)
hasLength(n)Проверить длинуexpect(list, hasLength(3))
greaterThan(n)знак большеexpect(score, greaterThan(60))
closeTo(value, delta)Числа с плавающей точкой приблизительно равныexpect(3.14, closeTo(3.1, 0.1))

Пример

Практическое применение различных Matchers:

import 'package:test/test.dart';

void main() {
  test(ПРИМЕР Различные примеры утверждений, () {
    // Базовое равенство
    expect(2 + 2, equals(4));

    // Логические значения
    expect('hello'.contains('h'), isTrue);
    expect(''.isEmpty, isTrue);

    // Проверка на null
    String? name;
    expect(name, isNull);
    name = 'EXAMPLE';
    expect(name, isNotNull);

    // Проверка типа
    expect('EXAMPLE', isA<String>());
    expect(42, isA<int>());

    // Список/строка содержит
    expect([1, 2, 3], contains(2));
    expect('Hello, EXAMPLE!', contains('EXAMPLE'));

    // Длина
    expect([1, 2, 3], hasLength(3));
    expect('Dart', hasLength(4));

    // Числовое сравнение
    expect(100, greaterThan(50));
    expect(30, lessThan(60));
    expect(75, greaterThanOrEqualTo(60));

    // Сравнение чисел с плавающей точкой (во избежание проблем с точностью)
    expect(0.1 + 0.2, closeTo(0.3, 0.001));

    // Коллекция не пуста
    expect([1, 2], isNotEmpty);

    // Равенство списков
    expect([1, 2, 3], equals([1, 2, 3]));

    // Map содержит ключ
    var user = {'name': 'example', 'age': 10};
    expect(user, containsPair('name', 'example'));
    expect(user.keys, contains('age'));
  });
}
00:00 +1: All tests passed!

Тестирование исключений

Пример

import 'package:test/test.dart';

int divide(int a, int b) {
  if (b == 0) throw ArgumentError(Делитель не может быть 0);
  return a ~/ b;
}

void main() {
  test(divide() должен выбрасывать исключение при делении на ноль, () {
    // Проверка, что выбрасывается любое исключение
    expect(() => divide(10, 0), throwsException);

    // Проверка, что выбрасывается исключение определённого типа
    expect(() => divide(10, 0), throwsArgumentError);

    // Проверка сообщения исключения
    expect(
      () => divide(10, 0),
      throwsA(predicate((e) =>
          e is ArgumentError &&
          e.message.contains(divisor))),
    );
  });

  test(divide() не выбрасывает исключение в обычных случаях, () {
    expect(() => divide(10, 2), returnsNormally);
    expect(divide(10, 2), equals(5));
  });
}
00:00 +2: All tests passed!

При тестировании исключений нужно обернуть код, который может выбросить исключение, в анонимную функцию (() => code), а не вызывать его напрямую. Если написать expect(divide(10, 0), throwsException) напрямую, divide немедленно выбросит исключение, и expect никогда не получит шанс выполниться.


Группировка тестов с помощью group()

group() используется для организации связанных тестовых случаев вместе, что делает структуру тестов более понятной.

Пример

import 'package:test/test.dart';

// Тестируемая функция
class StringUtils {
  static String capitalize(String s) {
    if (s.isEmpty) return s;
    return s[0].toUpperCase() + s.substring(1);
  }

  static String reverse(String s) {
    return s.split('').reversed.join('');
  }

  static bool isPalindrome(String s) {
    var clean = s.toLowerCase().replaceAll(' ', '');
    return clean == reverse(clean);
  }

  static int countWords(String s) {
    if (s.trim().isEmpty) return 0;
    return s.trim().split(RegExp(r'\s+')).length;
  }
}

void main() {
  // group() организация вложенных тестов
  group('StringUtils', () {
    // Подгруппа
    group('capitalize()', () {
      test(Делает первую букву обычного слова заглавной, () {
        expect(StringUtils.capitalize('hello'), equals('Hello'));
      });

      test(Слово, уже написанное с заглавной буквы, остаётся неизменным, () {
        expect(StringUtils.capitalize('Hello'), equals('Hello'));
      });

      test(Пустая строка возвращает пустую строку, () {
        expect(StringUtils.capitalize(''), equals(''));
      });

      test(Одиночный символ, () {
        expect(StringUtils.capitalize('a'), equals('A'));
      });
    });

    group('reverse()', () {
      test(Переворачивает обычную строку, () {
        expect(StringUtils.reverse('EXAMPLE'), equals('BOONUR'));
      });

      test(Обращение строки-палиндрома оставляет её неизменной, () {
        expect(StringUtils.reverse('aba'), equals('aba'));
      });

      test(Пустая строка, () {
        expect(StringUtils.reverse(''), equals(''));
      });
    });

    group('isPalindrome()', () {
      test(Строка-палиндром возвращает true, () {
        expect(StringUtils.isPalindrome('racecar'), isTrue);
        expect(StringUtils.isPalindrome('A man a plan a canal Panama'), isTrue);
      });

      test(Строка, не являющаяся палиндромом, возвращает false, () {
        expect(StringUtils.isPalindrome('hello'), isFalse);
      });

      test(Пустая строка считается палиндромом, () {
        expect(StringUtils.isPalindrome(''), isTrue);
      });
    });

    group('countWords()', () {
      test(Обычное предложение, () {
        expect(StringUtils.countWords('Hello World Dart'), equals(3));
      });

      test(Лишние пробелы, () {
        expect(StringUtils.countWords(' Hello World '), equals(2));
      });

      test(Пустая строка, () {
        expect(StringUtils.countWords(''), equals(0));
        expect(StringUtils.countWords('   '), equals(0));
      });
    });
  });
}
00:00 +12: All tests passed!

group() можно вкладывать друг в друга для создания иерархической структуры тестов.

Это делает отчёты о тестах более удобочитаемыми, а также помогает быстро находить падающие тесты.

Хорошая стратегия группировки — организовывать по «тестируемому модулю/классу/методу». Так, когда тест падает, вы сразу понимаете, в какой функциональности проблема.

setUp и tearDown

setUp выполняется перед каждым тестом, tearDown — после каждого теста.

Они используются для подготовки тестовой среды и очистки ресурсов.

Пример

import 'package:test/test.dart';

// Имитация класса, которому требуются инициализация и очистка
class Database {
  bool isConnected = false;

  void connect() {
    isConnected = true;
    print(Database connected);
  }

  void disconnect() {
    isConnected = false;
    print(База данных отключена);
  }

  String query(String sql) {
    if (!isConnected) throw Exception(База данных не подключена);
    return Результат запроса: $sql;
  }
}

void main() {
  group(Тест базы данных, () {
    late Database db;  // поздняя ленивая инициализация

    // Выполнить перед каждым тестом
    setUp(() {
      db = Database();
      db.connect();
      print([setUp] Подготовка тестовой среды);
    });

    // Выполнить после каждого теста
    tearDown(() {
      db.disconnect();
      print([tearDown] Очистка тестовой среды);
    });

    test(query() обычный запрос, () {
      var result = db.query('SELECT * FROM users');
      expect(result, contains('EXAMPLE') ? result.contains('users') : result.contains('users'));
      // Упростить утверждения
      expect(result, isNotEmpty);
    });

    test(query() может выполнять несколько запросов после подключения, () {
      var r1 = db.query('SELECT 1');
      var r2 = db.query('SELECT 2');
      expect(r1, isNotEmpty);
      expect(r2, isNotEmpty);
    });

    test(Запрос выбрасывает исключение, когда нет подключения, () {
      db.disconnect();  // Отключить вручную
      expect(() => db.query('SELECT 1'), throwsException);
    });
  });
}
  数据库已连接
  [setUp] 准备测试环境
  数据库已断开
  [tearDown] 清理测试环境
  数据库已连接
  [setUp] 准备测试环境
  数据库已断开
  [tearDown] 清理测试环境
  数据库已连接
  [setUp] 准备测试环境
  数据库已断开
  [tearDown] 清理测试环境
00:00 +3: All tests passed!

Обратите внимание на порядок выполнения setUp и tearDown в выводе — они выполняются один раз до и после каждого теста.

setUp и tearDown гарантируют, что каждый тест начинается с чистого состояния и не зависит от других тестов. Это ключевая гарантия независимости тестов.


Асинхронный тест

Пакет test для Dart изначально поддерживает асинхронное тестирование.

Тестовая функция может возвращать Future, и фреймворк автоматически дождётся завершения Future.

Пример

import 'package:test/test.dart';

// Асинхронная функция: имитация сетевого запроса
Future<String> fetchUserData(int userId) async {
  await Future.delayed(Duration(milliseconds: 100));

  if (userId <= 0) {
    throw Exception(Неверный ID пользователя);
  }

  return Данные пользователя $userId;
}

Future<List<int>> fetchNumbers() async {
  await Future.delayed(Duration(milliseconds: 50));
  return [1, 2, 3, 4, 5];
}

void main() {
  group(Асинхронный тест, () {
    test(fetchUserData() нормально получает данные, () async {
      var data = await fetchUserData(1);
      expect(data, equals(Данные пользователя 1));
    });

    test(fetchUserData() выбрасывает исключение для неверного ID, () async {
      expect(
        () => fetchUserData(-1),
        throwsA(isA<Exception>()),
      );
    });

    test('fetchNumbers() возвращает правильный список', () async {
      var numbers = await fetchNumbers();
      expect(numbers, hasLength(5));
      expect(numbers, contains(3));
      expect(numbers.first, equals(1));
    });

    // Тестирование нескольких асинхронных операций
    test('Последовательные асинхронные операции', () async {
      var data1 = await fetchUserData(1);
      var data2 = await fetchUserData(2);

      expect(data1, isNot(equals(data2)));
      expect(data1, contains('1'));
      expect(data2, contains('2'));
    });
  });
}
00:00 +4: All tests passed!

Общие команды для запуска тестов

КомандаОсобенности
dart testЗапустить все тесты
dart test test/calculator_test.dartЗапустить указанный тестовый файл
dart test --name="add"Запускать только тесты, имена которых содержат "add"
dart test --concurrency=4Запускать тесты параллельно (ускоряет работу)
dart test --reporter=expandedПодробный режим вывода
dart test --coverage=coverageСоздать данные покрытия тестами

Лучшие практики тестирования

ПрактикаОписание
Каждый тест должен проверять только одну вещьОдин test() соответствует одному поведению, что ускоряет определение места сбоя.
Имена тестов описывают поведение, а не реализацию"add() складывает два положительных числа" лучше, чем "тест add()".
Паттерн AAAОрганизация (Настройка) → Действие (Выполнение) → Утверждение (Проверка)
Сначала пишите падающие тестыУбедитесь, что тест может выявить ошибки, затем напишите код, чтобы он прошёл.
Тестирование граничных условийNull, ноль, отрицательные числа, очень большие значения, очень маленькие значения.
Держите тесты независимыми друг от другаРезультат одного теста не должен влиять на другой тест

Тесты — не бремя, а страховка. Чем больше тестов вы пишете, тем увереннее вы себя чувствуете при рефакторинге. Когда тест падает, вам не нужно гадать, что пошло не так — тест точно скажет вам об этом.


Итоги главы

В этой главе представлен полный рабочий процесс модульного тестирования на Dart: установка пакета test, написание тестовых случаев test(), использование утверждений expect(), организация с помощью group(), управление окружением с помощью setUp/tearDown и асинхронное тестирование.

Модульное тестирование — обязательный курс для профессиональных разработчиков; выработка привычки писать тесты будет постоянно повышать качество вашего кода.


Полное резюме руководства

Поздравляем с завершением вводного изучения языка программирования Dart!

Давайте рассмотрим учебный путь этих 21 главы:

ЭтапГлаваОсновное содержание
1. Основы начала работыГлавы 1-4Обзор Dart, настройка окружения, первая программа, базовый синтаксис.
2. Основные типы и управление потокомГлавы 5-8Переменные и типы данных, операторы, управление потоком, коллекции.
3. Функции и объектно-ориентированное программированиеГлавы 9-13Функции, классы и объекты, наследование и полиморфизм, интерфейсы и Mixin, обобщения.
4. Продвинутые возможностиГлавы 14-17Перечисления и символы, обработка исключений, управление пакетами и библиотеками, typedef.
5. Асинхронное программирование и тестированиеГлавы 18-21Асинхронное программирование, Streams, конкурентность и Isolate, модульное тестирование.

Освоив весь этот материал, вы уже можете использовать Dart для повседневной разработки.

Следующий шаг: вы можете углубиться.Flutter FrameworkПримените знания Dart для разработки UI на мобильных устройствах и в вебе.

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