webapp-testing

webapp-testing 技能是一個專業級工具組，專為開發人員與品質保證 (QA) 工程師設計，用於自動化、調試與驗證本地開發環境中的 Web 介面。透過利用 Playwright 框架，此技能允許代理程式與動態 Web 應用程式互動、擷取瀏覽器截圖、分析控制台日誌，並以程式化方式執行複雜的 UI 操作。它透過提供強大的輔助腳本來管理本地伺服器的生命週期，簡化了設定過程，確保在自動化任務開始前，後端與前端皆已準備就緒。

主要功能與能力包括：

• 原生 Playwright 整合，用於高保真瀏覽器自動化與 DOM 操作。
• 透過專用輔助腳本進行多伺服器生命週期管理，支援複雜技術堆疊的並行測試。
• 自動化偵察工作流程，使代理程式能檢測渲染狀態、透過截圖分析識別選擇器，並等待 networkidle 事件。
• 支援調試 UI 行為、日誌擷取，以及處理靜態 HTML 與動態 JavaScript 密集型應用程式。
• 基於模式的決策能力，可根據應用程式複雜度選擇直接 HTML 解析或完整的瀏覽器互動。

使用說明與實踐細節：

• 優先將隨附的輔助腳本作為黑盒工具使用，以管理伺服器相依性；使用 --help 參數來了解個別腳本功能。
• 對於動態 Web 應用程式，務必呼叫 wait_for_load_state('networkidle')，以防止在檢測或互動前發生 DOM 競爭條件。
• 在偵察過程中，利用全頁截圖與 DOM 檢查內容來識別穩定選擇器（如 roles、labels 或 IDs），而非脆弱的定位座標。
• 遵循建議的決策樹：對於靜態資產，直接解析；對於動態應用，確保在執行自動化腳本前已使用提供的工具初始化伺服器。
• 注意上下文視窗限制；將大型自動化腳本視為模組化元件，僅導入當前任務絕對需要的內容。