The requestPermission() static method of the IdleDetector interface returns a Promise that resolves with a string when the user has chosen whether to grant the origin access to their idle state. Resolves with "granted" on acceptance and "denied" on refusal.

None.

A Promise that resolves with "granted" or "denied".

Transient user activation is required. The user has to interact with the page or a UI element in order for this feature to work.

The following example uses a click event on a button to trigger requesting the user for permission to detect when user is idle.

startButton.addEventListener("click", async () => {
  if ((await IdleDetector.requestPermission()) !== "granted") {
    console.error("Idle detection permission denied.");
    return;
  }
});