Headers: Permissions-Policy.idle-detection
Permissions-Policy: idle-detection directive
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The HTTP Permissions-Policy header idle-detection directive controls whether the current document is allowed to use the Idle Detection API to detect when users are interacting with their devices, for example to report "available"/"away" status in chat applications.
Specifically, where a defined policy blocks use of this feature, IdleDetector.start() calls will return a Promise that rejects with a DOMException of type NotAllowedError.
Syntax
Permissions-Policy: idle-detection=<allowlist>;
<allowlist>-
A list of origins for which permission is granted to use the feature. See
Permissions-Policy> Syntax for more details.
Default policy
The default allowlist for idle-detection is self.
Specifications
| Specification |
|---|
| Idle Detection API> # api-permissions-policy> |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
idle-detection |
94 | 94 | No | 80 | No | 94 | No | 66 | No | 17.0 | 94 | No |
See also
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Permissions-Policy/idle-detection
