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 上彗星不飞。

这篇记录来自 2026-10-30 晚的透明度和截图调参,同一晚把毛玻璃也拆掉了, 见 拆掉毛玻璃。 回到笔记