Что такое паттерн Arrange-Act-Assert?

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** — это паттерн для структурирования тестов, явно разделённый на три фазы: **Arrange** (подготовка), **Act** (выполнение действия), **Assert** (проверка результата). Он делает тесты читаемыми, организованными и лёгкими для понимания.

## Три фазы

```text
ARRANGE → set up the test: create objects, prepare inputs, configure mocks, set state
ACT     → perform the ACTION being tested (call the function/method under test)
ASSERT  → verify the OUTCOME: check the result/behavior matches what's expected
→ A clear three-part structure for every test.
```

## Пример

```js
test('Cart calculates total with discount', () => {
  // ARRANGE — set up
  const cart = new Cart();
  cart.add({ price: 100 });
  cart.applyDiscount(0.1);          // 10% off

// ACT — perform the action under test
  const total = cart.getTotal();

// ASSERT — verify the result
  expect(total).toBe(90);
});
```

Три фазы визуально отчётливо разделены (часто пустыми строками или комментариями), что делает назначение теста очевидным: что подготавливается, что делается, что проверяется.

## Почему AAA помогает

```text
✓ READABILITY — clear structure; easy to see setup vs action vs verification
✓ FOCUS — encourages testing ONE action per test (one clear Act)
✓ MAINTAINABILITY — consistent structure across tests; easy to understand/modify
✓ Spot problems — too much in Arrange (complex setup) or multiple Acts (testing too much)
→ (Given-When-Then is the same idea, in BDD terms: Given setup, When action, Then outcome.)
```

## Почему это важно

Понимание паттерна Arrange-Act-Assert ценно, потому что он обеспечивает **простую, эффективную структуру для написания ясных, поддерживаемых тестов**, и это полезное практическое знание.

Паттерн — структурирование каждого теста на **Arrange** (подготовка контекста теста, входных данных и состояния), **Act** (выполнение одного тестируемого действия) и **Assert** (проверка того, что результат соответствует ожиданиям) — делает тесты читаемыми и хорошо организованными, с тем, что назначение сразу становится ясным (что подготавливается, что делается, что проверяется).

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

Следование AAA производит тесты, которые легко писать, понимать и поддерживать — ценно, поскольку тесты читаются и изменяются со временем, а непонятные тесты — это реальное бремя для поддержки.

Знание того, что **Given-When-Then** (формулировка BDD: Given — подготовка, When — действие, Then — результат) — это одна и та же идея, связывает AAA с подходами, ориентированными на поведение.

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