useFps

轻松跟踪 FPS

useFps 通过计算 requestAnimationFrame 回调来测量当前每秒帧数。它返回一个表示当前 FPS 的数字,在可配置的帧数(默认每 10 帧)内计算。这对于性能监控和自适应渲染非常有用。

使用场景

  • 在开发或调试覆盖层中显示实时 FPS 计数器
  • 当帧率低于阈值时自适应降低动画复杂度
  • 对组件或页面的渲染性能进行基准测试

注意事项

  • SSR 安全:在服务端渲染期间返回 0。服务端不会进行 requestAnimationFrame 调用。
  • 性能:该 hook 内部使用 requestAnimationFrame,开销很小。调整 every 选项以平衡准确性和更新频率。
  • 相关 hooks:参见 useIdle 了解用户不活动检测,可与基于 FPS 的自适应渲染互补使用。

Usage

Live Editor

function Demo() {
  const fps = useFps();

  return <div>FPS: {fps}</div>;
};
Result

API

useFps

Returns

number: 每秒帧数

Arguments

参数名描述类型默认值
options-UseFpsOptions | undefined-

UseFpsOptions

参数名描述类型默认值
every每过 x 帧计算一次number10