SuperAPI AI 工具集

playwright-cli

测试与质量

查看项目

更新于 10-16 07:07

技能介绍

用途

playwright-cli 是一个浏览器自动化命令行工具,用于网页测试、表单填写、截图和数据提取。当用户需要导航网站、与网页交互或执行浏览器自动化操作时可以使用它。

主要能力

核心交互

提供 open、goto、type、click、dblclick、fill、drag、hover、select、upload、check、uncheck、snapshot、eval、dialog-accept、dialog-dismiss、resize、close 等命令,覆盖页面打开、导航、元素操作、快照获取、脚本求值和对话框处理。

导航与键盘鼠标

导航命令包括 go-back、go-forward、reload。键盘命令包括 press、keydown、keyup。鼠标命令包括 mousemove、mousedown、mouseup、mousewheel,并支持右键操作。

保存与输出

支持 screenshot(可指定元素或文件名)和 pdf(可指定文件名)保存页面内容。

标签页管理

提供 tab-list、tab-new、tab-close、tab-select 命令,支持多标签页工作流。

存储管理

支持 state-save、state-load 保存和加载状态。Cookie 操作包括 cookie-list、cookie-get、cookie-set、cookie-delete、cookie-clear,可指定 domain、httpOnly、secure 等属性。LocalStorage 和 SessionStorage 均提供 list、get、set、delete、clear 操作。

网络与 DevTools

route 命令可拦截请求并返回指定状态码或响应体,route-list 和 unroute 用于管理路由。console 和 network 命令用于查看控制台和网络日志。run-code 可执行 Playwright 代码。tracing-start/tracing-stop 用于追踪,video-start/video-stop 用于视频录制。

安装与配置

安装命令为 playwright-cli install --skills 和 playwright-cli install-browser。open 命令支持 --browser 指定 chrome、firefox、webkit、msedge,支持 --extension 通过扩展连接浏览器,支持 --persistent 使用持久化配置,支持 --profile 指定配置目录,支持 --config 指定配置文件。close 关闭浏览器,delete-data 删除默认会话的用户数据。

浏览器会话

通过 -s=名称 创建命名会话,可对命名会话执行 open、click、close、delete-data 等操作。list 列出会话,close-all 关闭所有浏览器,kill-all 强制结束所有浏览器进程。

使用方式

快速开始示例:

# open new browser
playwright-cli open
# navigate to a page
playwright-cli goto https://playwright.dev
# interact with the page using refs from the snapshot
playwright-cli click e15
playwright-cli type "page.click"
playwright-cli press Enter
# take a screenshot
playwright-cli screenshot
# close the browser
playwright-cli close

表单提交示例:

playwright-cli open https://example.com/form
playwright-cli snapshot
playwright-cli fill e1 "user@example.com"
playwright-cli fill e2 "password123"
playwright-cli click e3
playwright-cli snapshot
playwright-cli close

多标签页工作流示例:

playwright-cli open https://example.com
playwright-cli tab-new https://example.com/other
playwright-cli tab-list
playwright-cli tab-select 0
playwright-cli snapshot
playwright-cli close

使用 DevTools 调试示例:

playwright-cli open https://example.com
playwright-cli click e4
playwright-cli fill e7 "test"
playwright-cli console
playwright-cli network
playwright-cli close

追踪示例:

playwright-cli open https://example.com
playwright-cli tracing-start
playwright-cli click e4
playwright-cli fill e7 "test"
playwright-cli tracing-stop
playwright-cli close

适用场景

  • 网页测试与自动化交互
  • 表单填写与提交
  • 页面截图与 PDF 导出
  • 数据提取
  • 多标签页操作
  • Cookie、LocalStorage、SessionStorage 管理
  • 网络请求拦截与模拟
  • 控制台与网络日志调试
  • 追踪与视频录制

限制

资料中未提供关于收费、价格、平台兼容性、性能效果等方面的具体说明。