テストにおけるアサーションとは何ですか？

Question

Accepted Answer

**アサーション**とは、テスト内で**ある条件が真であるかどうかをチェックする**文であり、実際の結果が期待される結果と一致することを検証します。アサーションはテストが合格か不合格かを判定する核となる仕組みです。アサーションが失敗すると、そのテストは失敗します。

## アサーションの役割

```text
An ASSERTION checks that something is as expected:
  → "assert that the actual value EQUALS the expected value"
  → if TRUE → the assertion passes; if FALSE → the assertion FAILS → the TEST FAILS
→ Assertions are how a test VERIFIES behavior (the "check" part of a test).
```

## 一般的なアサーションの種類

```js
// equality
expect(result).toBe(5);                  // strict equality
expect(obj).toEqual({ name: 'Ann' });    // deep/value equality (objects)

// truthiness / null
expect(value).toBeTruthy();
expect(value).toBeNull();
expect(value).toBeDefined();

// comparisons
expect(count).toBeGreaterThan(0);
expect(price).toBeLessThanOrEqual(100);

// collections / strings
expect(array).toContain('item');
expect(array).toHaveLength(3);
expect(text).toMatch(/pattern/);          // regex

// errors
expect(() => risky()).toThrow();          // expect a function to throw

// negation
expect(value).not.toBe(null);
```

## 良いアサーション

```text
✓ Assert the SPECIFIC expected outcome (clear what's being checked)
✓ Use the RIGHT matcher (toBe vs toEqual; specific > generic)
✓ Clear FAILURE messages (good assertions/matchers explain what failed)
✓ Don't over-assert (test one behavior) or under-assert (verify the actual result)
```

## なぜ重要なのか

アサーションを理解することは基本的です。なぜなら、アサーションは**テストが振る舞いを検証する核となる仕組み**であり、合格か不合格かを判定するからです。したがって、どんなテストを書く上でも欠かせない、必ず知っておくべき知識です。

アサーションは**ある条件が真であることをチェックし**（通常は実際の結果が期待される結果と一致することを確認し）、テストの「検証」部分にあたります。アサーションが合格すればチェックは成立し、失敗すればテストは失敗します。

アサーションがなければ、テストは実際には何も検証していないことになります。そのため、アサーションを理解することは意味のあるテストを書く上で基本となります。

**一般的なアサーションの種類**を理解すること、すなわち等価性（厳密な `toBe` とオブジェクトに対する深い／値の `toEqual` という重要な区別）、真偽値や null のチェック、比較、コレクションや文字列のチェック、エラーのアサーション（関数が例外を投げることの検証）、そして否定を理解することは、テストが何を検証すべきかを表現するために必要な実践的知識です。

**良いアサーションの実践**を理解すること、すなわち期待される具体的な結果をアサートすること（何をチェックしているかを明確にすること）、適切なマッチャーを使うこと（たとえばオブジェクト比較には `toBe` ではなく `toEqual` を使うこと）、明確な失敗メッセージを確保すること（失敗したテストが何が間違っていたかを説明できるようにすること）、そしてアサーションのバランスをとること（一つの振る舞いをテストしつつ、実際の結果を検証すること）は、明確で効果的なテストを書くことを反映しています。

アサーションはすべてのテストが振る舞いを検証する手段であり（テストを意味あるものにする基本的なチェックであり）、その種類、適切なマッチャー、良い実践を理解することはあらゆるテストを書く上で必要です。したがって、アサーションを理解することは欠かせない基礎的なテストの知識であり、テストの中核となる構成要素であり、期待される振る舞いを表現し検証するために必要であり、正しさを意味ある形でチェックするテストを書く上で基本となる、テストを書くすべての人にとっての基礎的な能力です。