Navigator: userActivation property
Baseline 2023Newly 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 |