webapp-testing

webapp-testing 技能為軟體代理程式提供了一個結構化的框架，用於對本地網頁應用程式執行端對端測試和偵察。透過運用 Playwright，它實現了對瀏覽器實例的程式化控制，非常適合開發人員、品質保證工程師以及需要驗證前端組件或在開發環境中除錯 UI 行為的 AI 代理。該技能旨在處理現代網頁堆疊的複雜性，包括動態渲染、網路同步和多伺服器編排。

• 使用 Python Playwright 進行自動化瀏覽器編排，包括無頭模式執行以提高效率。

• 本地開發伺服器的生命週期管理，支援具有多個後端和前端服務的複雜設置。

• 視覺化除錯與 DOM 檢查功能，包括全頁截圖和內容提取，用於選擇器識別。

• 內建支援「網路閒置 (networkidle)」等待模式，確保與 JavaScript 重度框架互動時的可靠性。

• 控制台日誌捕獲與分析，用於在自動化序列中排查執行時錯誤。

• 在編寫自訂自動化邏輯之前，請務必先查看輔助腳本的說明文件，以避免重複工作。

• 在處理動態網頁應用程式時，請務必等待 'networkidle' 狀態，確保在檢查或互動之前 DOM 已完全渲染。

• 使用基於角色、基於文字或 CSS ID 的特定選擇器來編寫穩健的測試腳本；避免依賴脆弱的 XPath。

• 使用隨附的 'scripts/with_server.py' 工具來管理伺服器生命週期，這有助於防止懸空進程並確保環境狀態一致。

• 將提供的輔助腳本視為黑盒工具，以盡量減少上下文視窗的佔用；僅在絕對需要進行自訂除錯時才讀取原始程式碼。

• 適用於自動化視覺回歸測試、驗證表單互動、驗證使用者流程以及一般前端組件評估等案例。