JavaScript Navigator userActivation Property

What You’ll Learn

navigator.userActivation returns a UserActivation object for the current window. Learn isActive (transient) vs hasBeenActive (sticky), why browsers gate APIs behind gestures, five examples, and try-it labs.

Introduction

Many browser features must wait for a user gesture — a click, tap, or key press — so pages cannot autoplay loud media, open device pickers, or go fullscreen without intent.

navigator.userActivation gives you a UserActivation object that answers two beginner-friendly questions:

• Is the user interacting right now? — isActive (transient activation)
• Has the user interacted at least once since load? — hasBeenActive (sticky activation)

Understanding the userActivation Property

Think of navigator.userActivation as a status light for user gestures on this tab — not a method you call to “activate” the user.

• UserActivation — object returned by the property.
• isActive — transient: user is currently interacting (or recently did).
• hasBeenActive — sticky: at least one interaction since page load.
• Triggers — button clicks, pointer touches, and similar interactions.
• Gated APIs — many features require sticky or transient activation.

📝 Syntax

General form of the property:

navigator.userActivation

Value

• A UserActivation object for the current window.

Common patterns

// Feature-detect:
if ("userActivation" in navigator) {
  // Supported
}

// Transient activation (MDN):
if (navigator.userActivation.isActive) {
  // proceed to request playing media, for example
}

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

Examples Gallery

Examples follow MDN navigator.userActivation patterns. Prefer Try It Yourself — click the page to see sticky activation flip to true.

const supported = "userActivation" in navigator;
console.log(supported ? "userActivation available" : "userActivation missing");

userActivation available

if (!("userActivation" in navigator)) {
  console.log("userActivation not supported");
} else {
  console.log("isActive: " + navigator.userActivation.isActive);
  console.log("hasBeenActive: " + navigator.userActivation.hasBeenActive);
}

isActive: false
hasBeenActive: false
(often both false on a fresh load before any click)

function report() {
  if (!("userActivation" in navigator)) {
    return "userActivation not supported";
  }
  return (
    "isActive: " + navigator.userActivation.isActive +
    "\nhasBeenActive: " + navigator.userActivation.hasBeenActive
  );
}

console.log("before click:\n" + report());
// After a button click, call report() again — hasBeenActive should be true.

before click:
isActive: false
hasBeenActive: false
(after click in the lab: hasBeenActive becomes true)

function tryStartMedia() {
  if (!("userActivation" in navigator)) {
    return "API missing — use a click handler as a fallback.";
  }
  if (navigator.userActivation.isActive) {
    return "Transient activation OK — proceed to request playing media.";
  }
  return "Not active yet — ask the user to click a Play button first.";
}

console.log(tryStartMedia());

Not active yet — ask the user to click a Play button first.
(or the OK message when called inside a click handler)

function maybeAnimate() {
  if (!("userActivation" in navigator)) {
    return "API missing.";
  }
  if (navigator.userActivation.hasBeenActive) {
    return "Sticky activation OK — proceed with an animation.";
  }
  return "Waiting for the first user gesture on this page.";
}

console.log(maybeAnimate());

Waiting for the first user gesture on this page.
(or the OK message after the user has clicked once)

🚀 Common Use Cases

• Media autoplay UX — show Play until transient activation is available.
• Device APIs — call pickers (usb, serial, hid) from a click when isActive.
• Fullscreen / clipboard — many features need a user gesture window.
• Soft engagement gates — start decorative animations after hasBeenActive.
• Debugging gated failures — log activation flags when an API rejects without a gesture.

📝 Notes

• Baseline Widely available (MDN, since November 2023).
• Not Deprecated, Experimental, or Non-standard — no status banner required.
• Window context only — not available in workers.
• Read-only UserActivation with isActive and hasBeenActive.
• Related: userAgent, usb, serial, hid.

💡 Best Practices