Arrange-Act-Assertパターンとは何ですか？

Question

Accepted Answer

**Arrange-Act-Assert (AAA)** は、テストを3つのフェーズに明確に構造化するパターンです：**Arrange**（セットアップ）、**Act**（アクション実行）、**Assert**（結果検証）。これにより、テストは読みやすく、組織的で、理解しやすくなります。

## 3つのフェーズ

```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);
});
```

3つのフェーズは視覚的に明確です（通常、空行またはコメントで区切られます）。テストの意図が明らかになります：何がセットアップされ、何が実行され、何が検証されるか。

## なぜ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が役立つのか**を理解することが重要な価値です：**可読性**の向上（明確な3部構成の構造により、テストは従いやすい）、**焦点の促進**（1つのActフェーズがあるため1つのアクションのみ、焦点を絞ったテストを促進し、1つの振る舞いを検証）、**保守性の向上**（テストスイート全体で一貫した構造）、**問題の発見**（Arrangeの過度なセットアップは複雑な依存関係を示唆し、複数のActはテストが多くのことをしていることを示唆）。

AAAに従うことで、テストは書きやすく、理解しやすく、保守しやすくなります —— テストは時間とともに読まれ、変更されるため価値があり、不明確なテストは本当の保守負担です。

**Given-When-Then**（BDDの表現法：Givenセットアップ、Whenアクション、Thenアウトカム）がAAAと同じ考えであることを知ることで、AAAを行動駆動型アプローチに結びつけます。

明確でよく構造化された保守しやすいテストを書くことは重要です（テストはコードであり、理解され、保守される必要があります）し、AAAはそのためのシンプルで効果的な構造を提供します。そしてパターンとその利点を理解することは、より良いテストを書くのに役立つため、Arrange-Act-Assertパターンを理解することは価値のある実用的に関連のある知識です —— 明確で焦点を絞った保守しやすいテストを書くためのシンプルだが効果的な実践。広く使用され、テスト品質の向上に価値があり、テストを書く人にとって有用な習慣です。