For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh-tw/docs/web/testing.md (or send Accept: text/markdown).

測試策略

理解確定性、瀏覽器、資料庫與供應商檢查各自證明瞭什麼。

詢問本指南

安裝與配置

在執行任何步驟之前，請閱讀開始之前和終端基礎知識。這些說明假設您在 VS Code 中開啟了完整的 supastack monorepo；它的根 package.json 標記儲存庫根。在 pnpm 命令中，工作區包是應用程式或共享程式碼資料夾；在產品中，工作空間是團隊的資料容器和安全邊界。 corepack pnpm --filter ... 從 monorepo 選擇一個包，同時從其根執行命令。如果您僅開啟同步的移動或桌面資料夾，則它不包含 Web 後端、Docker 設定或根指令碼：從此 monorepo 或可訪問的託管伺服器執行後端，並使用平臺資料夾自己的指令碼。環境變數是儲存在本地 .env 檔案或託管儀錶板中的命名設定；更改後重新啟動相關應用程式，並將伺服器機密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1. 開啟repository-root package.json檢視檢查命令。

2. 從該根資料夾執行 corepack pnpm test 進行自動化單元測試，然後執行 corepack pnpm --filter @supastack/web typecheck 進行 Web TypeScript 檢查。

3. 對於瀏覽器行為，啟動 Web 應用程式並執行 corepack pnpm test:e2e。預期：每個命令報告自己的結果；單元測試並不能證明真實的資料庫、支付提供商、電子郵件服務或電話是否有效。

預設測試套件使用確定性的 fake/本地介面卡。瀏覽器測試覆蓋使用者互動；資料庫驗收與外部供應商冒煙是獨立門檻。先跑與變更行為相關的檢查，再擴大範圍。

corepack pnpm test
corepack pnpm check
corepack pnpm build
corepack pnpm test:e2e
corepack pnpm test:e2e:production

要複製的命令

按照註釋檢視命令在哪個資料夾中執行。如果標記了兩個終端，請開啟兩個終端視窗，並在使用第二個命令時保持第一個命令執行。

corepack pnpm test
corepack pnpm --filter @supastack/web typecheck
corepack pnpm test:e2e

實現流程

行為變更先寫一個失敗的驗收測試。讓成功訪問與匿名、跨工作區被拒成對出現。對錶單與任務流，除正常路徑外還要驗證載入、錯誤與恢復行為。

被攔截的瀏覽器響應證明的是介面對該夾具的反應，而不是認證持久化、支付處理、供應商投遞或真機回撥。

驗證與排障

如果資料庫測試表明它已被跳過，請在報告資料庫覆蓋率之前設定其隔離的測試資料庫。如果Web選項卡位於埠3001，則它是單獨的apps/docs伺服器；該套件 Web 應用程式在埠 3000 處啟動。如果 Playwright 在首次 Windows 執行時失敗，請完成瀏覽器安裝並重新執行失敗的命令；切勿關閉系統範圍的安全性來解決它。

資料庫門檻測試跳過時，先配置它的隔離測試資料庫，再聲稱該門檻已通過。如果瀏覽器 runner 斷言全綠卻在 teardown 掛住，兩個事實都要報告；卡住的程式不是乾淨的成功命令。

在 Windows 上，當 Defender 掃描新安裝的 Playwright 瀏覽器或依賴項時，初始瀏覽器執行可能會超時。讓安裝完成，使用 corepack pnpm test:e2e 或 corepack pnpm test:e2e:production 重新執行失敗的套件，並檢查其跟蹤和防禦者保護歷史記錄（如果再次失敗）。啟用系統範圍的保護。

本地瀏覽器套件擁有埠 3100，並拒絕重用已在該埠偵聽的程式。如果另一個應用程式擁有 3100，則將 PLAYWRIGHT_PORT 設定為 corepack pnpm test:e2e 之前的空閒埠；這可以防止測試悄悄地針對另一個專案。