SuperAPI AI 工具集

playwright-cli

测试与质量

查看项目

更新于 10-16 06:16

技能介绍

用途:通过终端命令控制浏览器会话,完成导航、表单填写、截图、标签页流程以及 console/网络调试等自动化任务。资料基于本机安装的 playwright-cli 0.0.62 验证,并提示以已安装 CLI 的 help 与真实运行行为为准。

主要能力:可打开/前进/后退/刷新页面,生成快照(可保存为文件)、整页或元素截图、导出 PDF;执行点击、填写、选择、勾选、按键、悬停、双击、拖拽等交互;支持标签页与会话管理(tab-new、tab-list、tab-select、tab-close、session-*);提供 console、network 诊断产物;可通过 eval、run-code 调用 Playwright API 处理等待、弹窗、下载、文件选择、媒体模拟、Cookie、地理位置等边缘情况;支持文件上传(需先触发文件选择器)。

使用方式:先做一次性启动,例如 which playwright-cli || npm install -g @anthropic-ai/playwright-cli@latest、playwright-cli install --browser=chrome、playwright-cli config --browser=chrome --isolated;默认流程为 open <url>、snapshot、screenshot --filename=step-1.png,再执行 click/fill/select 等操作后重新 snapshot 并截图。任何有意义的界面变化后应重新生成快照再复用 refs。文件上传用法为 upload /absolute/path/to/file,且需在文件选择器激活后执行。涉及关键正确性时,用 eval 获取浏览器真实状态并配截图作为证据。

适用场景:网页表单验证、搜索/筛选/排序流程、多标签页验证、视觉测试、console/网络问题排查,以及多个代理共享浏览器会话时的标签页协作。

限制:快照是某一时刻的无障碍树导出,不是实时 DOM 句柄,refs 在导航、切标签、重渲染或 run-code 改变页面状态后可能失效;tab-new [url] 实际可能打开 about:blank,建议分开执行 tab-new 与 open;zsh 中 URL 需加引号;应使用 select 的选项值而非可见标签;不要沿用已过时的 -s=name、--persistent、--profile 说明;console/network 返回的是需自行查看的产物文件,可能为空;产物路径属实现细节,应以 CLI 返回路径为准;资料未提供收费、价格、平台支持范围等信息。