Frames 是一项测量交互动画是否流畅的技能。它在节流 CPU 下录制一次交互的性能追踪,把每个慢帧归因到具体原因,然后用第二次录制证明修复有效。
用途
用于验证用户交互(如打开抽屉、输入字符、滚动面板)在动画过程中是否保持流畅,并定位导致掉帧或输入延迟的代码。
主要能力
- 精确预算判断:每帧落在单个刷新间隔内(60Hz 下为 16.7ms),运动期间没有动画帧超过 50ms,交互响应在 200ms 内绘制。没有数字的“感觉流畅”会被视为一项发现。
- CPU 节流:通过浏览器模拟调用将 CPU 节流 4 倍,代表中端手机。未节流的笔记本上的追踪会被标记为
frames-throttle-the-cpu。 - 录制方式:通过浏览器的 evaluate 调用运行
observe.js,调用window.__frames.start(),执行交互三次,再调用window.__frames.stop()。长帧没有命名脚本时,额外录制完整性能剖析。 - 预算读取:将录制结果与预算对比,掉帧或运动中的长动画帧标记为
frames-hold-the-budget;交互时长超过 200ms 标记为frames-answer-in-200ms,并指明时间花在输入延迟、处理还是呈现。 - 原因定位:读取每个长帧的脚本及其强制布局时间,再定位到代码。常见原因包括:在大子树上动画布局属性(
frames-compositor-properties)、循环中读写样式造成强制同步布局(frames-no-forced-layout)、每帧状态更新导致组件树重渲染(frames-animate-outside-render)、每帧重绘大面积表面(frames-small-paint)。 - 修复验证:用相同步骤和相同节流再次录制,并排报告两次录制。没有第二次录制的修复会被标记为
frames-before-and-after。完成后清除 CPU 节流。
使用方式
- 命名交互:写下路由、步骤和关键瞬间,例如“打开命令面板并输入三个字母”。通过浏览器模拟调用将 CPU 节流 4 倍。
- 录制:通过 evaluate 运行
observe.js,调用 start,执行交互三次,调用 stop。 - 读取预算:对比录制与预算,标记掉帧、长动画帧和超时交互。
- 查找原因:读取长帧脚本与强制布局时间,定位代码。
- 追踪修复:相同步骤和节流下再次录制,并排报告。
适用场景
- 验证抽屉、面板、命令面板等交互动画是否流畅。
- 定位掉帧或输入延迟的具体代码原因。
- 证明性能修复有效。
限制
- 浏览器不支持长动画帧时,脚本归因标记为“未验证”。
- 运动值本身应是什么属于 motion 技能;逐帧拆解运动属于 deconstruct 技能;打开运行结果属于 verify 技能。
- 严重程度分级:HIGH 为节流下交互超过 200ms,或报告流畅但无录制;MEDIUM 为运动期间掉帧、大子树布局属性动画、强制布局、每帧状态更新,或无节流的追踪;LOW 为保持预算的大面积重绘,或无第二次录制的修复。存在任何 HIGH 时阻止,否则批准。
- 输出格式:每个根因一项发现,带测量数字,格式为
file:line - [rule-id] 问题描述(掉帧数、最差间隔、时长),随后是 Rule | Count | Severity 汇总。