2026-10-30 · 技术笔记 · 前端
静态截图抓不到飞行的彗星
无头 Chrome 的两个开关
改完彗星背景,想用截图验收,结果连拍两张一字不差,
都是 738686 字节。不是页面没变,是 requestAnimationFrame 在无头模式里根本没跑。
验收 canvas 动画最省事的思路是用无头 Chrome 出一张图:给一点
--virtual-time-budget,等动画跑一会儿,再落盘。站点背景的彗星由
requestAnimationFrame 驱动,按这个思路应该能看到飞行中的画面。
实际结果:第一张 738686 字节,第二张还是 738686 字节——一模一样。
这说明两次截图的内容完全相同,画布还停在第零帧之前。
虚拟时间不等同于动画时间
--virtual-time-budget 快进的是定时器与部分任务队列,
但无头浏览器没有真实显示器,合成器不会像带窗口的浏览器那样稳定地产生帧。
requestAnimationFrame 的下一步回调依赖帧信号,帧信号不来,
循环一次都不执行。把预算从 6 秒加到 20 秒,截图字节数纹丝不动,
也侧面证明了这一点:等待时长不是变量。
顺手还验证了另一头:用同一命令拍三张,如果动画真的随机, 三张的字节数应该各不相同——后来也确实拿到了 1304188、1309044、1307075 三个互不相同的数字。截图工具的确定性没有问题,问题只在动画有没有跑。
用「减少动态效果」换一帧静态画面
站点背景脚本本来就为 prefers-reduced-motion 留了降级分支:
不启动动画循环,只调用一次绘制。于是截图时加一个开关
--force-prefers-reduced-motion,强制页面走这条分支。
脚本在初始化时就已给每条彗星随机「预热」了最多半个生命周期,
所以这一帧不是从屏幕边缘出发的空画面,彗星分布在整屏,正好能检查
它们与文字块重叠时的效果。
这个做法还有一个副作用值得记下来:静态分支只画一帧,验收对象从 「动画是否流畅」变成了「某一帧的构图是否成立」。对调透明度、调颜色 这类视觉改动,这恰好是想要的那一帧。要验收流畅度,就得上带窗口的浏览器, 或者用开发者工具里的性能面板采样,不能指望命令行截图。
--force-prefers-reduced-motion 抓静态帧;
macOS 命令行窗口最小 500 像素,想看 390 宽的手机版,得套 iframe 再截图。
后记:静态帧的入口换成了 URL 参数
这篇发出后,有读者反映 Windows 上彗星不飞——原因是背景脚本跟随系统
「减少动态效果」走了静态分支。当晚把降级分支删掉、动画改成常开,
需要一帧静态画面做截图验收时,改用 ?static=1。
动画本身是否在跑,则改用 DevTools 协议隔一秒采样两次画布来验收,
见 Windows 上彗星不飞。