Navigator: userActivation property
Baseline 2023
Newly available
Since November 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
The read-only userActivation
property of the Navigator
interface returns a UserActivation
object which contains information about the current window's user activation state.
Value
A UserActivation
object.
Examples
Checking if a user gesture was recently performed
Use UserActivation.isActive
to check whether the user is currently interacting with the page (Transient activation).
js
if (navigator.userActivation.isActive) {
// proceed to request playing media, for example
}
Checking if a user gesture was ever performed
Use UserActivation.hasBeenActive
to check whether the user has ever interacted with the page (Sticky activation).
js
if (navigator.userActivation.hasBeenActive) {
// proceed with auto-playing an animation, for example
}
Specifications
Specification |
---|
HTML Standard # dom-navigator-useractivation |
Browser compatibility
BCD tables only load in the browser