SuperAPI AI 工具集

playwright

测试与质量

查看项目

更新于 10-16 05:07

技能介绍

用途:用真实浏览器打开 URL、截图并与页面交互,用于对网页内容做可视化验证,例如设计稿、本地开发服务器、线上站点等。

主要能力:启动有头 Chromium 浏览器;导航到指定 URL 并截图;点击、输入、按键、滚动、悬停等交互;等待特定元素;批量对多个 URL 截图;通过 Cookie 处理需要登录的页面;自定义视口与移动设备模拟;捕获控制台与页面错误辅助调试。

使用方式:Playwright 安装在 /Users/espen/node_modules/playwright,脚本需从该绝对路径 require。将 .cjs 脚本写入 /tmp/ 后用 node 运行,再读取生成的 PNG。示例:const { chromium } = require('/Users/espen/node_modules/playwright'); 启动时使用 chromium.launch({ headless: false })。导航用 page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 }),随后按站点类型等待:静态 HTML 1-2 秒,简单 SPA 3-4 秒,复杂 SPA 6-8 秒。截图保存到 /tmp/。

限制与注意:必须使用有头模式,无头模式常导致 SPA 空白或报错;必须用 CommonJS(.cjs)与绝对路径 require,ESM import 会失败;避免用 networkidle,WebSocket 应用可能超时;截图空白可增加等待;需要认证时设置 Cookie 或使用分享链接;截图模糊可在 context 中设置 deviceScaleFactor: 2。

适用场景:网页视觉检查、SPA 渲染验证、多页面截图、带登录页面的截图与简单交互测试。其他功能与收费信息暂未提供。