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 ：指定 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：安装指定配置中的浏览器。如果出现浏览器未安装的错误，请调用此命令。
  • 参数：无。