IdleDetector.requestPermission()

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

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.

Syntax

requestPermission()

Parameters

None.

Return value

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

Examples

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

Specifications

Specification
Idle Detection API
# api-idledetector-requestpermission

Browser compatibility

BCD tables only load in the browser