Что такое AAA в тестировании?

Что такое AAA (Arrange, Act, Assert) в тестировании?

AAA (Arrange, Act, Assert) — это широко распространённый и элегантный паттерн структурирования unit-тестов (модульных тестов). Его главная цель — сделать тесты максимально читаемыми, предсказуемыми и легко поддерживаемыми, разделив логику теста на три чётких, логически обособленных этапа. Это не специфический PHP-паттерн, а общий принцип, который идеально ложится на тестирование в PHP с использованием фреймворков вроде PHPUnit.

Детальное описание трёх фаз (A-A-A)

Давайте разберём каждую фазу на примере тестирования простого сервиса на PHP.

1. Arrange (Подготовка, Организация)

На этом этапе мы подготавливаем все необходимые условия для выполнения теста. Это включает в себя:

• Создание экземпляров тестируемого объекта (например, сервиса или класса).
• Настройку заглушек (stubs) или мок-объектов (mocks) для зависимостей с использованием библиотек вроде Mockery или встроенных возможностей PHPUnit.
• Определение входных данных.
• Установку ожидаемого результата (expected result), если это применимо.

Цель этапа: Создать контролируемое и изолированное окружение для теста. Исходное состояние системы должно быть полностью определено.

2. Act (Действие, Выполнение)

Это единственный шаг, на котором мы вызываем непосредственно тот метод или функцию, которую тестируем. Мы выполняем действие с подготовленными данными.

Цель этапа: Получить фактический результат (actual result) работы тестируемого кода. Этот шаг должен быть максимально простым и обычно представляет собой одну строку кода.

3. Assert (Проверка, Утверждение)

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

• Проверяем возвращаемое значение.
• Проверяем изменения состояния объекта.
• Убеждаемся, что были вызваны ожидаемые методы у мок-объектов (например, с помощью ->shouldHaveReceived() в Mockery).

Цель этапа: Верифицировать корректность работы тестируемого кода. Весь тест считается пройденным, только если все утверждения на этом этапе выполняются успешно.

Пример на PHP с использованием PHPUnit

Допустим, у нас есть сервис OrderProcessor, который зависит от PaymentGateway.

<?php
// Класс, который мы тестируем
class OrderProcessor {
    private $paymentGateway;

    public function __construct(PaymentGateway $paymentGateway) {
        $this->paymentGateway = $paymentGateway;
    }

    public function process(Order $order): bool {
        $result = $this->paymentGateway->charge($order->getTotalAmount());
        if ($result) {
            $order->setStatus('paid');
            return true;
        }
        return false;
    }
}

Тест по паттерну AAA будет выглядеть так:

<?php
use PHPUnit\Framework\TestCase;

class OrderProcessorTest extends TestCase {
    public function testOrderIsMarkedAsPaidOnSuccessfulCharge(): void {
        // ARRANGE: Подготовка
        $order = new Order(100.0); // Создаём тестовый заказ на 100 у.е.
        $order->setStatus('pending');

        // Создаём мок (заглушку) для PaymentGateway
        $paymentGatewayMock = $this->createMock(PaymentGateway::class);
        // Настраиваем мок: метод charge с аргументом 100.0 должен вернуть true
        $paymentGatewayMock->method('charge')
                           ->with(100.0)
                           ->willReturn(true);

        // Создаём экземпляр тестируемого сервиса, передавая ему мок
        $processor = new OrderProcessor($paymentGatewayMock);

        // ACT: Действие
        $result = $processor->process($order);

        // ASSERT: Проверка
        $this->assertTrue($result); // Проверяем, что процесс вернул true
        $this->assertEquals('paid', $order->getStatus()); // Проверяем изменение статуса
        // Можно также проверить, что метод charge был вызван ровно один раз:
        // (Это требует использования Prophecy или Mockery для более удобной проверки)
    }
}

Ключевые преимущества использования AAA

• Улучшенная читаемость: Любой разработчик, даже не знакомый с кодом, может быстро понять, что тестируется, как это выполняется и какой результат ожидается. Тест становится самодокументируемым.
• Стандартизация: Паттерн создаёт единую, узнаваемую структуру для всех тестов в проекте. Это упрощает их написание, чтение и рефакторинг.
• Надёжность и предсказуемость: Чёткое разделение этапов предотвращает смешивание логики подготовки и проверки, что снижает вероятность ошибок в самих тестах.
• Лёгкость поддержки: Если тест начинает падать, структура AAA позволяет быстро локализовать проблему: она в подготовке (неверные данные), в действии (изменение API) или в проверке (неверные ожидания).
• Фокус на одном сценарии: Паттерн естественным образом подталкивает к тому, чтобы один тест проверял один конкретный сценарий (one assertion per test — хотя это правило иногда нарушается в пользу проверки связанных условий), что делает тесты более атомарными.

Заключение

AAA (Arrange, Act, Assert) — это фундаментальный и мощный паттерн, который лежит в основе написания чистых и эффективных модульных тестов. Его adoption значительно повышает качество тестового кода, что напрямую влияет на надёжность, сопровождаемость и долгосрочную жизнеспособность кодовой базы PHP-проекта. Следование этому простому правилу — признак зрелости процесса разработки и забота о будущем проекта.