SuperAPI AI 工具集

playwright-skill

测试与质量

查看项目

更新于 10-16 06:18

技能介绍

用途:playwright-skill 是面向浏览器自动化的通用技能,会根据用户描述的具体任务编写自定义 Playwright 代码并执行,可用于测试页面、填写并提交表单、截图、检查失效链接、验证登录跳转、响应式设计检查等。

主要能力:自动探测本地运行中的开发服务器(detectDevServers),支持多视口截图(桌面/平板/移动)、登录流程验证、表单填写、链接状态检查、错误处理、设备与网络相关的高级用法(详见 API_REFERENCE.md)。默认使用可见浏览器(headless: false),除非明确要求无头模式。提供 lib/helpers.js 辅助函数,如 safeClick、safeType、takeScreenshot、handleCookieBanner、extractTableData,并支持通过环境变量注入自定义 HTTP 请求头。

使用方式:先确定技能目录 $SKILL_DIR;本地测试前先运行服务器探测:cd $SKILL_DIR && node -e "require('./lib/helpers').detectDevServers().then(servers => console.log(JSON.stringify(servers)))";首次使用执行 cd $SKILL_DIR && npm run setup 安装 Playwright 与 Chromium。脚本写入 /tmp/playwright-test-.js,通过 cd $SKILL_DIR && node run.js /tmp/playwright-test-.js 执行;简单任务可用内联方式运行。URL 需参数化,放在脚本顶部常量或环境变量中。自定义请求头可用 PW_HEADER_NAME/PW_HEADER_VALUE 或 PW_EXTRA_HEADERS 配置。

适用场景:本地或外部站点的页面验证、表单与登录流程测试、视觉截图与响应式检查、失效链接排查,以及需要可见浏览器辅助调试的自动化任务。

限制:测试文件不应写入技能目录或用户项目,仅用 /tmp;默认非无头模式需有可用显示环境;未安装 Playwright 时需先运行 setup;关于收费、价格与平台支持等具体信息,资料暂未提供。