IdleDeadline:timeRemaining() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

IdleDeadline 接口的 timeRemaining() 方法返回当前空闲期间剩余的估计毫秒数。回调函数可以随时调用此方法,以确定在必须返回之前还可以继续工作多长时间。例如,如果回调函数完成了一个任务并有另一个任务要开始,它可以调用 timeRemaining() 来查看是否有足够的时间完成下一个任务。如果没有,回调函数可以立即返回,或者寻找其他工作来利用剩余时间。

timeRemaining() 达到 0 时,建议回调函数应将控制权返回给用户代理的事件循环。

语法

js
timeRemaining()

参数

无。

返回值

一个 DOMHighResTimeStamp 值(一个浮点数),表示用户代理估计当前空闲期间剩余的毫秒数。该值理想情况下精确到大约 5 微秒以内。

如果 IdleDeadline 对象的 didTimeout 属性为 true,此方法返回零。

示例

请参阅文章 后台任务的协作调度 API 中的完整示例

规范

规范
requestIdleCallback()
# dom-idledeadline-timeremaining

浏览器兼容性

另见