tester-army/e2e
Next generation e2e testing framework for web and mobile apps.
這是什麼
tester-army/e2e 是一個面向 Web 與行動 App 的端到端測試框架，核心想法是把傳統測試裡最脆弱、最耗時的操作步驟，交給能理解自然語言目標的 agent 來執行。README 的範例裡，測試先打開 billing 頁，再用 agent.act('upgrade the workspace to the Pro plan') 描述意圖，接著用 agent assertion 與一般 locator/assertion 檢查結果。它不是要完全取代測試斷言，而是把自然語言操作與可驗證的測試條件放在同一支測試中。比較關鍵的是，已被後續 assertion 驗證過的 agent 步驟會記錄行為；下一次在 App 未變更時可重播，避免每次都呼叫模型。沒有 agent step 的測試也不需要模型。
為什麼上榜
這個專案在日榜拿到 345 顆今日新增星、總星數 3,077，熱度來自它切中目前自動化測試的兩個痛點：一是 UI 流程常因細節變動而脆弱，二是純 AI 操作若沒有嚴格驗證又不夠可靠。e2e 的賣點正好站在兩者中間：讓 agent 負責接近使用者意圖的操作，但仍用 locator、assertion 與可重播紀錄來收斂不確定性。它也同時支援 Web 與 mobile，Web 端透過 Playwright 的 Chromium、Firefox、WebKit，行動端則連到 simulator／emulator，讓「同一套測試語法描述跨平台目標」變得更有吸引力。不過 README 也明講專案仍在邁向 1.0 的 active development，API 與設定可能在 minor release 間改變，這是採用時必須接受的風險。
適合誰，可以拿來做什麼
它最適合已經有 E2E 測試需求、但被複雜互動流程拖慢的產品團隊：例如 SaaS 後台、結帳流程、設定頁、或需要跨瀏覽器與行動模擬器驗證的 App。若團隊本來就熟悉 TypeScript 測試、Playwright 或 CI，它的上手門檻會較低；如果完全沒有自動化測試基礎，仍需要理解 runner、assertion、測試資料與環境穩定性。README 提到可自帶訂閱、API key 或本地模型，因此它也適合想把模型供應商選擇權留在自己手上的團隊。另一個實用場景是 pull request：README 列出 @e2e-dev/github reporter，可把結果作為 PR comment 回報。
上手
README 提供的 quick start 非常短，主要入口是初始化 CLI：
npx e2e init
init 會詢問要使用的 engine、Web 或 mobile，以及模型 provider，然後寫入設定檔與範例測試。README 也指出更完整流程在官方 quickstart 文件中，且 e2e package 會附帶文件頁面，coding agents 可以在 node_modules/e2e/docs 離線閱讀。若在正式專案導入，建議先從一條高價值但容易人工驗證的流程開始，確定 agent step 的重播與 assertion 行為符合預期，再擴大到更多場景。
README 重點摘要
- 自然語言 agent step 可描述操作目標，並與一般 locator／assertion 混寫在同一支測試。
- 支援 Web 與 mobile：Web 透過 Playwright，mobile 透過 simulator／emulator 相關引擎。
- 已驗證的 agent 行為可在後續執行重播，App 未變更時可減少模型呼叫。
- CLI 會送匿名使用資料，但不含測試內容、App 內容或 credentials；可用
npx e2e telemetry disable或E2E_TELEMETRY_DISABLED=1關閉。 - 專案仍在 1.0 前 active development，API 與 config 可能變動。