Repolode
microsoft

microsoft/playwright-cli

面向编码代理的 Playwright 命令行工具,通过简洁命令控制浏览器、录制代码并检查元素。

Star
15,007
Fork
901
未关闭 Issue
21
最近提交
前天

这是什么?

playwright-cli 将 Playwright 的常用浏览器操作封装为 shell 命令。Claude Code、GitHub Copilot 等编码代理可以通过它打开页面、点击和填写元素、截图、把用户操作录制为 Playwright 代码,并检查选择器,而无需把大量工具定义和页面数据塞入模型上下文。开发者也可以手动执行同样的命令,用于探索网站或调试流程。

工具会在命名会话中保持浏览器状态,Cookie 和存储数据在浏览器关闭前可跨命令保留。会话可以持久化到磁盘,支持有界面或无头模式运行,并可通过可视化面板查看和控制。元素可以通过快照引用、CSS 选择器或 Playwright 定位器指定。

除交互操作外,它还支持 tracing、视频录制、网络请求拦截与模拟、存储和 Cookie 管理、设备与配色方案模拟,以及实验性的 WebMCP 工具调用。配置可通过 JSON 文件或环境变量完成,需要 Node.js 18 或更高版本。

核心功能

  • 01在命令行中执行点击、填写、跳转、截图等常用 Playwright 操作。
  • 02录制浏览器操作并生成对应的 Playwright 代码。
  • 03支持命名会话隔离,并可选择持久化浏览器配置。
  • 04提供可视化面板,用于查看和接管正在运行的会话。
  • 05支持 tracing、视频录制和网络请求模拟。
  • 06可用快照引用、CSS 选择器或 Playwright 定位器定位元素。

适用场景

  • 让编码代理测试 Web 应用的操作流程,并截取成功与失败步骤的截图。
  • 手动运行命令,在可见浏览器中交互式调试页面。
  • 录制用户操作流程并转换为 Playwright 测试代码。
  • 编写端到端测试时检查选择器和元素属性。

快速上手

  1. 1

    使用 npm 全局安装 CLI

    npm install -g @playwright/cli@latest
  2. 2

    安装智能体技能

    playwright-cli install --skills
  3. 3

    打开浏览器并访问页面

    playwright-cli open https://playwright.dev --headed

使用前须知

  • 需要 Node.js 18 或更高版本。
  • 主要面向编码智能体设计,并非通用测试运行器。

收录于专题

标签

常见问题

playwright-cli 是什么?
面向编码代理的 Playwright 命令行工具,通过简洁命令控制浏览器、录制代码并检查元素。 playwright-cli 将 Playwright 的常用浏览器操作封装为 shell 命令。Claude Code、GitHub Copilot 等编码代理可以通过它打开页面、点击和填写元素、截图、把用户操作录制为 Playwright 代码,并检查选择器,而无需把大量工具定义和页面数据塞入模型上下文。开发者也可以手动执行同样的命令,用于探索网站或调试流程。
playwright-cli 可以免费使用吗?用的什么许可证?
playwright-cli 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
playwright-cli 还在维护吗?
活跃维护中。playwright-cli 最近一次提交是在 2026年11月5日。
playwright-cli 适合用来做什么?
让编码代理测试 Web 应用的操作流程,并截取成功与失败步骤的截图。 手动运行命令,在可见浏览器中交互式调试页面。 录制用户操作流程并转换为 Playwright 测试代码。 编写端到端测试时检查选择器和元素属性。
playwright-cli 怎么安装和运行?
使用 npm 全局安装 CLI: npm install -g @playwright/cli@latest 安装智能体技能: playwright-cli install --skills 打开浏览器并访问页面: playwright-cli open https://playwright.dev --headed
在哪里获取 playwright-cli?
源代码和安装说明在 GitHub 上:https://github.com/microsoft/playwright-cli

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目