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).

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).

if (navigator.userActivation.hasBeenActive) {
  // proceed with auto-playing an animation, for example
}

Specifications

Specification
HTML Standard # dom-navigator-useractivation

Browser compatibility