SuperAPI AI 工具集

run-playwright

测试与质量

查看项目

更新于 10-16 04:59

技能介绍

用途:当任务需要真实浏览器会话和交互式命令行控制时使用本技能,例如打开并验证页面实际渲染结果、填写表单与上传文件并证明结果、在运行中管理标签页与弹窗、采集截图与控制台/网络日志作为证据;仅当 CLI 缺少直接命令时才使用 run-code 短片段。若任务是编写或评审 Playwright 测试代码、纯 HTTP 抓取或静态爬取已足够,或需要托管浏览、反爬绕过等远程路由,则不应使用本技能。

主要能力:命令涵盖导航(open、reload、go-back、go-forward)、输入(fill、type、select、check、uncheck、press)、点击悬停、视口调整、文件上传、标签页(tab-new、tab-list、tab-select、tab-close)、对话框、截图、PDF、视频、观察(snapshot、eval)、调试(console、network)、追踪与会话管理,以及 run-code 自定义代码。

使用方式:playwright-cli 为每次调用一条命令、背后保持持久会话状态。安装与初始化: which playwright-cli || npm install -g @anthropic-ai/playwright-cli@latest playwright-cli install --browser=chrome 建议每次初始化都执行 install --browser=chrome,二进制已存在时为空操作。工作流为先确认标签页与会话状态(先 tab-new 再 open <url>,不要用 tab-new <url>),然后用 snapshot 配合 cat 读取生成的 YAML 文件获取 refs,再执行最小直接命令,最后立即验证。

限制与注意:refs 视为一次性,导航、重渲染、提交或切换标签后需重新 snapshot;快照、截图、console、network 等产物写入文件(通常在 .playwright-cli/ 下),需读取文件而非只看输出;eval "() => window.location.href" 是 URL 的可靠来源;console --clear 与 network --clear 静默无输出属正常;mousewheel 参数顺序在部分版本可能颠倒,需先用小值测试。file://、localhost 或局域网地址可能无法从浏览器上下文访问,此时改用 data: URL、公开可达的暂存地址,或告知用户无法访问。清理时只关闭自己创建的临时标签页与会话,保留共享或既有会话。