idle

Runs a callback when the browser or system is idle — via requestIdleCallback (falling back to setTimeout) or the Chromium-only Idle Detection API.

Import: @rtorcato/browser-common/idle

📖 MDN: Idle Detection API · 📊 caniuse: IdleDetector

The Idle Detection API (detectIdle) is Chromium-only, requires a permission grant and a secure context, and returns null when unavailable — check with isIdleDetectionApiAvailable() first. onIdle/cancelIdle use requestIdleCallback and work everywhere via the setTimeout fallback.

Browser support

API	Chrome	Edge	Firefox	Safari	iOS Safari	Baseline
IdleDetector	✅ 94+	✅ 114+	❌	❌	❌	Limited
Window.requestIdleCallback	✅ 47+	✅ 79+	✅ 55+	❌ flag only	❌	Limited

✅ supported · ◐ partial · ❌ not supported · [n] see note. Generated from MDN browser-compat-data and web-features. caniuse: IdleDetector · Window.requestIdleCallback

Example

import {
  isIdleDetectionApiAvailable,
  onIdle,
  cancelIdle,
  detectIdle,
} from '@rtorcato/browser-common/idle'

const id = onIdle((deadline) => doWork(deadline))
cancelIdle(id)

if (isIdleDetectionApiAvailable()) {
  const detector = await detectIdle(
    () => lockUI(),
    () => unlockUI()
  )
}

Exports

• isIdleDetectionApiAvailable() — feature check for the Idle Detection API
• onIdle(callback, options?) — schedules a callback via requestIdleCallback (or setTimeout fallback)
• cancelIdle(id) — cancels a callback registered with onIdle
• detectIdle(onIdle, onActive?) — starts the Idle Detection API, returns the detector or null

See the API reference for full signatures.