SuperAPI AI 工具集

chrome-devtools

测试与质量

查看项目

更新于 10-16 02:29

技能介绍

用途:以命令行脚本方式驱动 Chrome 浏览器,实现自动化操作与页面分析,脚本输出 JSON,便于下游解析与串联。

主要能力:navigate.js 访问 URL;screenshot.js 截取整页或元素截图;click.js、fill.js 完成点击与表单填写;evaluate.js 在页面上下文执行 JavaScript;snapshot.js 提取可交互元素及元数据;console.js 监控控制台消息与错误;network.js 跟踪 HTTP 请求与响应;performance.js 测量 Core Web Vitals 并记录 trace。

使用方式:脚本位于 .claude/skills/chrome-devtools/scripts/。Linux/WSL 先执行 ./install-deps.sh 安装系统依赖(支持 Ubuntu、Debian、Fedora、RHEL、CentOS、Arch、Manjaro;macOS/Windows 可跳过),再运行 npm install 安装 puppeteer、debug、yargs。示例:node navigate.js --url https://example.com;截图需保存至 ./docs/screenshots 目录。可链式复用浏览器:navigate.js 加 --close false 保持浏览器打开,后续脚本继续操作。通用选项含 --headless false、--close false、--timeout 30000、--wait-until networkidle2。输出统一为 stdout 的 JSON,错误写入 stderr。常用工作流包括网页抓取、性能测试、表单自动化与错误监控,可配合 jq 提取字段。

限制与注意:元素找不到时先用 snapshot.js 获取选择器;脚本挂起可增大 timeout 或更换等待策略;空白截图可改用 --wait-until networkidle2。缺少依赖或浏览器启动失败时,按资料提示运行 npm rebuild、npm install 或 npx puppeteer browsers install chrome。脚本权限不足需 chmod +x *.sh。其余高级用法与完整选项暂未提供。