SuperAPI AI 工具集

playwright-cli

测试与质量

查看项目

更新于 10-16 05:41

技能介绍

用途:playwright-cli 是一个基于 Playwright 的命令行浏览器自动化工具,定位为面向编码智能体、token 高效的 CLI,适合自动化测试与网页交互流程。

安装:npm install -g @playwright/mcp@latest,随后可用 playwright-cli --help 查看帮助。

主要能力:打开与关闭页面(open <url>、close);元素交互(type、click、dblclick、fill、drag、hover、check、uncheck、select);页面导航(go-back、go-forward、reload);键盘与鼠标(press、keydown、keyup、mousemove、mousedown、mouseup、mousewheel);保存导出(screenshot [ref]、pdf);标签页管理(tab-list、tab-new、tab-close、tab-select);开发者工具(console、network、run-code、tracing-start、tracing-stop);会话管理(session-list、session-stop、session-stop-all、session-delete)。snapshot 用于捕获页面快照以获取元素 ref,供后续命令引用。

使用方式:典型流程为 open 打开页面,type 输入文本,press Enter 提交,screenshot 截图。可用 --session 指定隔离会话,例如 playwright-cli --session=project-a open https://site2.com。有头模式:playwright-cli open https://example.com --headed。

配置与环境变量:支持 PLAYWRIGHT_MCP_BROWSER(chrome、firefox、webkit、msedge)、PLAYWRIGHT_MCP_HEADLESS、PLAYWRIGHT_MCP_ALLOWED_HOSTS、PLAYWRIGHT_MCP_CONFIG;也可创建 playwright-cli.json 持久化设置,包含 browser、outputDir、console 等字段。

限制与说明:跨平台,需 Node.js 18+(Linux、macOS、Windows);会话默认持久化 cookie 与存储;快照返回的元素 ref 用于后续命令。其余细节暂未提供。