Модульное тестирование в 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):
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):
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 | Проверить null | expect(value, isNull) |
| contains(value) | Содержит элемент (список) или подстроку (строку). | expect(list, contains('a')) |
| isA | Проверить типы | expect(obj, isA |
| throws | Проверить, что исключение выброшено | expect(() => f(), throwsException) |
| isNotEmpty | не null | expect(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:
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!
Тестирование исключений
Пример
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() используется для организации связанных тестовых случаев вместе, что делает структуру тестов более понятной.
Пример
// Тестируемая функция
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 — после каждого теста.
Они используются для подготовки тестовой среды и очистки ресурсов.
Пример
// Имитация класса, которому требуются инициализация и очистка
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.
Пример
// Асинхронная функция: имитация сетевого запроса
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 на мобильных устройствах и в вебе.
Другие расширения