R
fn

useIdle

v0.0.15testeddemo

Track whether the user has been inactive for a given duration.

Examples

ts
const { idle, lastActive, reset } = useIdle(5 * 60_000); // 5 minutes
ts
const { idle } = useIdle(10_000, { events: ['keydown'] });

Demo

Loading demo…

Signature

ts
export function useIdle(
  timeout: number = ONE_MINUTE,
  options: UseIdleOptions ={ ... }

Parameters

ParameterTypeDescription
timeout?numberIdle threshold in milliseconds
options?UseIdleOptionsOptions

Returns

UseIdleReturn`{ idle, lastActive, isPending, reset, start, stop }`