大网数据广告活动
Web 标准与前端开发

requestIdleCallback

· 52CE 我爱测

`window.requestIdleCallback()`** 方法插入一个函数,这个函数将在浏览器空闲时期被调用。这使开发者能够在主事件循环上执行后台和低优先级工作,而不会影响延迟关键事件,如动画和输入响应。函数一般会按先进先调用的顺序执行,然而,如果回调函数指定了执行超时时间`timeout`,则有可能为了在超时前执行函数而打乱执行顺序。

HTML DOM

window.requestIdleCallback() 方法插入一个函数,这个函数将在浏览器空闲时期被调用。这使开发者能够在主事件循环上执行后台和低优先级工作,而不会影响延迟关键事件,如动画和输入响应。函数一般会按先进先调用的顺序执行,然而,如果回调函数指定了执行超时时间timeout,则有可能为了在超时前执行函数而打乱执行顺序。

你可以在空闲回调函数中调用 requestIdleCallback(),以便在下一次通过事件循环之前调度另一个回调。

[!NOTE] 强烈建议为必要的工作设置 timeout 选项,否则在回调触发之前可能已经过去了多秒。

语法

requestIdleCallback(callback)
requestIdleCallback(callback, options)

参数

  • callback
    • : 一个在事件循环空闲时即将被调用的函数的引用。函数会接收到一个名为 IdleDeadline 的参数,这个参数可以获取当前空闲时间以及回调是否在超时时间前已经执行的状态。
  • options
    • : 包括可选的配置参数。具有如下属性:
      • timeout:如果指定了 timeout,并且有一个正值,而回调在 timeout 毫秒过后还没有被调用,那么回调任务将放入事件循环中排队,即使这样做有可能对性能产生负面影响。

返回值

一个 ID,可以把它传入 Window.cancelIdleCallback() 方法来结束回调。

示例

请阅读我们这篇后台任务 API 的协同调度文章中的完整示例。

规范

浏览器兼容性

参见

  • Window.cancelIdleCallback()
  • IdleDeadline
  • Window.setTimeout()
  • Window.setInterval()
  • Window.requestAnimationFrame()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。