Playwright MCP

🚀 Playwright 命令指南

Playwright 是一個強大的工具，能夠簡化跨瀏覽器測試的工作流。它提供了一站式自動化解決方案，支持多種瀏覽器，並具備豐富的功能，可幫助開發者輕鬆實現頁面交互、截圖、導航、鍵盤操作等多種功能，確保測試的全面性和可靠性。

🚀 快速開始

使用 playwright CLI 啟動瀏覽器並運行命令

要啟動瀏覽器並在其上運行命令，請使用 playwright CLI：

# 在 chrome 上運行 "whoAmI" 命令
playwright chrome -- eval 'await page.evaluate(() => { return window.whoAmI; })'

# 在 firefox 上運行 ".getTitle"
playwright firefox -- get-title

# 在 webkit 上運行 "getScreenInfo"
playwright webkit -- get-screen-info

✨ 主要特性

Playwright 提供了一站式自動化解決方案，支持多種瀏覽器，並提供了豐富的功能：

1. 多平臺支持：在同一代碼庫中測試 Chromium、Firefox 和 WebKit。
2. 內置工具：包括斷言（assertions）、文件下載處理和自動生成的等待條件。
3. 可擴展性：允許通過插件系統添加自定義功能。

📚 詳細文檔

Playwright 支持的瀏覽器及其命令

Playwright 目前支持以下瀏覽器：

• chromium
  • --headless：以無頭模式（即沒有圖形界面）啟動。
  • --no-sandbox：禁用沙盒模式。
• firefox
  • -p <profile>：指定 Firefox 的配置文件路徑。
• webkit
  • --remote-debugging：啟用遠程調試功能。

Browser Playgrounds 列表

以下是 Playwright 支持的 Browser Playgrounds 命令列表：

基本操作

• browserSnapshot：捕獲當前頁面的可訪問性快照，這對於後續操作更有效。
• browserTakeScreenshot：拍攝當前頁面的截圖。無法基於此截圖執行操作，請使用 browserSnapshot 進行操作。

文件和媒體

• browserFileUpload：上傳文件到指定位置。
  • 參數：paths（數組）— 要上傳的文件絕對路徑，可以是一個或多個文件。
• browserPdfSave：將頁面保存為 PDF 文件。
  • 參數：無。

導航

• browserNavigate：導航到指定 URL。
  • 參數：url（字符串）— 要導航到的目標 URL。
• browserNavigateBack：返回上一頁。
  • 參數：無。
• browserNavigateForward：跳轉到下一頁。
  • 參數：無。

鍵盤操作

• browserPressKey：按鍵盤上的某個鍵。
  • 參數：key（字符串）— 要按下的鍵的名稱或生成的字符，例如 ArrowLeft 或 a。

控制檯

• browserConsoleMessages：返回所有控制檯消息。
  • 參數：無。

等待和關閉

• browserWait：等待指定的時間（以秒為單位）。
  • 參數：time（數字）— 要等待的時長，最長限制為 10 秒。
• browserClose：關閉當前頁面。
  • 參數：無。

安裝瀏覽器

• browserInstall：安裝指定配置中的瀏覽器。如果出現瀏覽器未安裝的錯誤，請調用此命令。
  • 參數：無。