IdleDetector.requestPermission()

The requestPermission() 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".

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;
  }
})