condition-based-waiting

條件式等待 (Condition-Based Waiting) 技能為現代軟體測試提供了一種穩健的架構模式，專門用於取代導致持續整合 (CI/CD) 管線與平行執行環境不穩定的脆弱性「sleep」或「timeout」呼叫。該技能取代了猜測程序執行時間的方法（這是導致測試在本機環境通過、但在高負載生產環境失敗的主因），改為實作精確的基於輪詢的同步機制。這適用於軟體工程師、QA 自動化專家與 DevOps 專業人員，特別是在處理非同步框架、複雜狀態機或事件驅動 UI 元件時。透過等待明確的狀態變更或特定條件的滿足，測試套件變得更具彈性、可預測性，並透過減少不必要的緩衝時間來提升執行速度。

• 實作具備可配置逾時臨界值的通用輪詢工具，防止無窮迴圈並確保在條件未滿足時測試能快速失敗。

• 為常見的非同步陷阱提供即時解決方案，例如等待檔案系統 IO、狀態轉換、事件發射或計數器閾值。

• 透過在目標狀態達成時立即恢復執行，取代等待固定的「最壞情況」計時器，進而大幅縮短測試執行時間。

• 透過消除與排程、網路延遲或高負載相關的競爭條件 (Race Conditions)，增強測試套件在持續整合環境中的穩定性。

• 藉由強制開發者定義明確的成功標準，提升測試文件的撰寫品質，使每次等待操作背後的意圖更加明確。

• 推薦應用於使用 React、TypeScript、Playwright、Selenium 或任何事件驅動非同步系統的開發環境。

• 使用策略：除非是在測試如 debounce 或 throttle 等時間敏感間隔，否則應一律優先採用條件式等待，而非隨意的逾時設定。

• 輸入需求：預期接收一個布林值或非 null/undefined 的條件函數、用於錯誤日誌的描述性識別碼，以及選用的逾時持續時間。

• 約束說明：避免將輪詢間隔設定過低（例如 <10ms）以節省 CPU 資源；建議針對大多數非效能敏感的測試案例將預設間隔設為 10ms。

• 當觸發逾時限制時，請務必包含描述性的錯誤訊息，這有助於偵錯複雜的競爭條件或邏輯失敗路徑。