Playwright 教學手冊
Playwright 教學手冊（企業級完整版） 版本：基於 Playwright v1.59.1（2026 年 4 月） 適用對象：資深工程師、SDET、QA Lead、DevOps 工程師 授權：Apache 2.0（Playwright 開源授權） 最後更新：2026-04-12 目錄 第 1 章：Playwright 總覽 1.1 什麼是 Playwright 1.2 Playwright 核心架構 1.3 Playwright vs. Selenium vs. Cypress 比較 1.4 適用場景 1.5 系統需求 第 2 章：系統架構設計（企業級） 2.1 測試架構總覽 2.2 分層設計 2.3 測試資料管理策略 2.4 多環境配置 2.5 與微服務架構整合 第 3 章：安裝與環境建置 3.1 Node.js 安裝 3.2 Python 安裝 3.3 Java 安裝 3.4 專案目錄結構 3.5 VS Code 設定 3.6 Playwright MCP Server 設定 3.7 Playwright CLI 安裝 3.8 Playwright Agents 設定（v1.56+） 3.9 企業環境安裝注意事項 第 4 章：基礎使用教學 4.1 第一個測試案例 4.2 Locator 使用策略 4.3 Auto-wait 機制 4.4 Assertions（Web-First 驗證） 4.5 Headless / Headed 模式 第 5 章：進階功能 5.1 Codegen（錄製測試） 5.2 Playwright Inspector 5.3 Trace Viewer 5.4 Network 攔截（Mock API） 5.5 多分頁 / iframe 操作 5.6 檔案上傳與下載 5.7 視覺測試（Screenshot Comparison） 5.8 認證狀態重用（Auth State） 5.9 Screencast API（v1.59+） 5.10 Browser Interoperability（v1.59+） 5.11 Observability Dashboard（v1.59+） 5.12 CLI Debugger for Agents（v1.59+） 5.13 CLI Trace 分析（v1.59+） 5.14 Async Disposables — await using（v1.59+） 第 6 章：測試設計最佳實踐 6.1 Page Object Model（POM）完整實作 6.2 減少 Flaky Test 策略 6.3 測試命名規範 6.4 自訂 Fixtures 第 7 章：CI/CD 整合（企業級重點） 7.1 GitHub Actions 7.2 GitLab CI 7.3 Jenkins Pipeline 7.4 測試報告整合 7.5 測試失敗通知 7.6 Docker 化測試執行 7.7 WebServer Wait 功能（v1.57+） 7.8 testConfig.tag — 全域標籤（v1.57+） 第 8 章：測試報告與監控 8.1 Playwright HTML Report 8.2 Trace 分析 8.3 自訂 Reporter 8.4 測試結果 Dashboard 第 9 章：系統維運與管理 9.1 測試環境管理 9.2 測試資料清理 9.3 測試排程 9.4 平行測試（Parallel Execution） 9.5 測試資源最佳化 第 10 章：升級與版本管理策略 10.1 Playwright 版本升級策略 10.2 Breaking Changes 處理 10.3 瀏覽器版本管理 10.4 回滾策略 第 11 章：安全與合規（銀行級） 11.1 敏感資料處理 11.2 測試帳號管理 11.3 存取控制（RBAC） 11.4 稽核與日誌（Audit Log） 第 12 章：團隊導入指南 12.1 Playwright 導入 Roadmap 12.2 導入里程碑 12.3 團隊角色分工 12.4 Code Review 規範 12.5 教育訓練計畫 第 13 章：完整專案範本 13.1 專案結構 13.2 完整 playwright.config.ts 範本 13.3 完整 package.json 範本 13.4 .gitignore 範本 13.5 Tag 使用策略 附錄 A：新進成員檢查清單（Checklist） 附錄 B：常用指令速查表 附錄 C：參考資源 第 1 章：Playwright 總覽 1.1 什麼是 Playwright Playwright 是由 Microsoft 開發並開源的瀏覽器自動化與端對端（E2E）測試框架，採用 Apache 2.0 授權。它透過單一 API 驅動 Chromium、Firefox 與 WebKit 三大瀏覽器引擎，支援 Windows、Linux、macOS 跨平台執行。 ...