W3cubDocs

/Web APIs

IdleDeadline

The IdleDeadline interface is used as the data type of the input parameter to idle callbacks established by calling Window.requestIdleCallback(). It offers a method, timeRemaining(), which lets you determine how much longer the user agent estimates it will remain idle and a property, didTimeout, which lets you determine if your callback is executing because its timeout duration expired.

To learn more about how request callbacks work, see Collaborative Scheduling of Background Tasks.

Instance properties

IdleDeadline.didTimeout Read only

A Boolean whose value is true if the callback is being executed because the timeout specified when the idle callback was installed has expired.

Instance methods

IdleDeadline.timeRemaining()

Returns a DOMHighResTimeStamp, which is a floating-point value providing an estimate of the number of milliseconds remaining in the current idle period. If the idle period is over, the value is 0. Your callback can call this repeatedly to see if there's enough time left to do more work before returning.

Example

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
IdleDeadline 47 79 55 No 34 No 47 47 55 34 No 5.0
didTimeout 47 79 55 No 34 No 47 47 55 34 No 5.0
timeRemaining 47 79 55 No 34 No 47 47 55 34 No 5.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IdleDeadline