tai-ch0802/testing-mastery

測試精通 — 統一測試技能

撰寫能記錄意圖、捕捉回歸錯誤且快速執行的測試。針對不同情境選擇正確的策略。

決策樹：該用哪種測試策略？

這是新功能嗎？
├─ 是 → 使用 TDD（參見 references/tdd-cycle.md）
│        撰寫失敗測試 → 最小化程式碼 → 重構
└─ 否
   ├─ 這是 Bug 修復嗎？
   │  └─ 是 → 先撰寫回歸測試，再修復
   ├─ 這是關鍵使用者流程（登入、結帳）嗎？
   │  └─ 是 → E2E 測試（參見 references/e2e-playwright.md）
   └─ 這是商業邏輯 / 資料轉換嗎？
      └─ 是 → 單元 + 整合測試（參見 references/unit-integration.md）

測試金字塔

        /\          E2E（少量，~10%）
       /  \         僅限關鍵使用者流程
      /----\
     /      \       整合測試（適量，~20%）
    /--------\      API、資料庫、服務契約
   /          \
  /------------\    單元測試（大量，~70%）
                    函式、類別、工具

核心原則

| 原則 | 規則 | |------|------| | AAA | 佈置（Arrange）→ 執行（Act）→ 斷言（Assert） | | 快速 | 單元測試 < 100ms，整合測試 < 1s | | 隔離 | 測試之間沒有相依性 | | 行為 | 測試「做什麼」，而非「怎麼做」 | | 最小化 | 每個測試一個斷言（理想情況） |

快速參考

| 我需要... | 使用 | 參考 | |-----------|------|------| | 以測試優先的方式建構功能 | TDD（RED-GREEN-REFACTOR） | tdd-cycle.md | | 撰寫單元/整合測試 | Mocking、資料策略、模式 | unit-integration.md | | 在瀏覽器中測試關鍵使用者流程 | E2E + Playwright | e2e-playwright.md |

反模式（通用）

| ❌ 不要 | ✅ 應該 | |---------|---------| | 測試實作細節 | 測試可觀察的行為 | | 出貨後才寫測試 | 在開發前/中撰寫測試 | | 複製測試程式碼 | 使用工廠與固定資料 | | 複雜的測試設定 | 簡化或拆分 | | 忽略不穩定測試 | 修復根本原因 | | 跳過清理 | 在 teardown 中重設狀態 | | 每個測試多個斷言 | 每個測試一個行為 |

🔧 執行腳本

| 腳本 | 用途 | 指令 | |------|------|------| | scripts/test_runner.py | 統一測試執行 | python scripts/test_runner.py <project_path> | | scripts/playwright_runner.py | 瀏覽器 E2E 測試 | python scripts/playwright_runner.py <url> | | | 附帶截圖 | python scripts/playwright_runner.py <url> --screenshot | | | 無障礙檢查 | python scripts/playwright_runner.py <url> --a11y |

記住： 測試就是規格。如果你寫不出測試，那代表你不了解需求。