SuperAPI AI 工具集

playwright-cli

测试与质量

查看项目

更新于 10-16 07:19

技能介绍

用途:playwright-cli 是 @anthropic-ai/playwright-cli 提供的命令行浏览器自动化工具,用 bash 命令控制无头 Chromium,适用于页面导航、表单填写、数据提取、视觉测试与调试等任务。

主要能力:每条改变页面的命令会返回快照——YAML 可访问性树,其中可交互元素带 e5、e12 之类 ref,用于点击、填写和交互。支持导航(open、go-back、go-forward、reload)、观察(snapshot、screenshot)、简单交互(click、fill、select、check、hover、dblclick、drag、upload)、键盘操作、eval、标签页、对话框、DevTools(console error、network)、会话管理与录制(视频、trace、pdf)。

使用方式:先一次性引导:which playwright-cli || npm install -g @anthropic-ai/playwright-cli@latest;PLAYWRIGHT_SKIP_VALIDATE_HOST_REQUIREMENTS=true npx playwright install chromium;playwright-cli session-stop 2>/dev/null;playwright-cli config --browser=chromium。完成后运行 playwright-cli session-stop-all。核心流程是观察-行动循环:open → snapshot → screenshot → 决策 → click/fill → snapshot(必需)→ screenshot。CLI 命令优先;仅在 CLI 无法完成(如等待条件、网络拦截、设置 cookie 或地理定位、原子多步操作)时用 run-code。

限制与注意事项:ref 在任何页面变化(click、open、hover、reload、go-back、tab-select 等)后即失效,必须重新 snapshot;tab-new 只打开 about:blank,需再 open URL;快照不反映表单当前值,需用 eval "(el) => el.value" 验证;console 和 network 返回文件路径而非内容,需读取文件;close 会终止整个浏览器会话,子代理应只用 tab-close;tab-close 后索引变化,必须立即 tab-list,tab-select 后必须 snapshot;模态对话框会阻塞,需先 dialog-accept 或 dialog-dismiss;fill 会先清空并按 ref 定位,type 只向焦点元素追加,两者不可互换。资料未提供具体收费、价格、平台支持范围或效果数据。