SuperAPI AI 工具集

recording

测试与质量

查看项目

更新于 10-16 00:21

技能介绍

用途:使用 Playwright 进行浏览器自动化录屏,录制 Web 应用操作演示,并生成带时间线的屏幕录像。

主要能力:单次连续录制(不分段);通过 TimelineRecorder 记录每个操作的精确时间戳并输出 timeline.json;使用真实或有意义的测试数据;控制操作节奏以留出画面呈现时间。

使用方式:脚本基于 playwright 的 chromium,设置 viewport(示例 1920x1080)与 recordVideo 输出目录,headless 设为 false,slowMo 放慢操作。页面加载用 waitUntil: "networkidle" 并等待 1.5-3 秒;点击后等待 1-2 秒;表单输入 0.5-1 秒;弹窗 1.5-2 秒;数据加载 2-3 秒;场景切换 2-3 秒。可用逐字输入(delay 80)模拟真实输入,用 hover 展示 tooltip。录制完成后可用 FFmpeg 转 MP4:ffmpeg -y -i ${webmPath} -c:v libx264 -preset fast -crf 23 ${mp4Path}。

时间线规范:需记录页面加载完成、主要区域就绪、每次点击、数据加载完成、弹窗开关、录制结束等事件,命名如“点击[按钮名]按钮”。

限制与排错:Chromium 未安装时执行 npx playwright install chromium;黑屏需确保 headless: false;操作过快可增大 slowMo 或 waitForTimeout;元素未找到建议使用稳定选择器(如 button:has-text("查询")),避免 nth-child 之类脆弱选择器。