UserActivation

Baseline 2023

Neu verfügbar

Seit November 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.

Das UserActivation-Interface bietet Informationen darüber, ob ein Benutzer derzeit mit der Seite interagiert oder seit dem Laden der Seite eine Interaktion abgeschlossen hat.

Diese API ist nur im Fensterkontext verfügbar und nicht für Worker zugänglich.

In diesem Artikel

Instanz-Eigenschaften

UserActivation.hasBeenActive Schreibgeschützt

Gibt an, ob das aktuelle Fenster eine dauerhafte Benutzeraktivierung hat.

UserActivation.isActive Schreibgeschützt

Gibt an, ob das aktuelle Fenster eine vorübergehende Benutzeraktivierung hat.

Beschreibung

Ein Objekt dieses Typs wird über die navigator.userActivation-Eigenschaft aufgerufen und kann verwendet werden, um Informationen über den Benutzeraktivierungszustand eines Fensters abzufragen.

Eine Benutzeraktivierung bedeutet entweder, dass der Benutzer derzeit mit der Seite interagiert oder seit dem Laden der Seite eine Interaktion abgeschlossen hat. Eine Benutzeraktivierung kann durch einen Klick auf eine Schaltfläche, Berühren mit dem Zeiger oder eine andere Nutzerinteraktion mit der Seite ausgelöst werden.

Es gibt zwei Arten von Benutzeraktivierungszuständen für Fenster:

Vorübergehende Aktivierung (Benutzer interagiert derzeit mit der Seite) und
Dauerhafte Aktivierung (Benutzer hat mindestens einmal seit dem Laden der Seite interagiert).

Weitere Informationen und eine Liste von APIs, die eine dauerhafte oder vorübergehende Benutzeraktivierung erfordern, finden Sie unter Features gated by user activation.

Beispiele

Überprüfen, ob kürzlich eine Benutzeraktion durchgeführt wurde

Verwenden Sie navigator.userActivation, um auf das UserActivation-Objekt zuzugreifen, und dann UserActivation.isActive, um zu prüfen, ob der Benutzer derzeit mit der Seite interagiert (Vorübergehende Aktivierung).

js
if (navigator.userActivation.isActive) {
  // proceed to request playing media, for example
}

Überprüfen, ob jemals eine Benutzeraktion durchgeführt wurde

Verwenden Sie UserActivation.hasBeenActive, um zu prüfen, ob der Benutzer jemals mit der Seite interagiert hat (Dauerhafte Aktivierung).

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

HTML DOM API
UserActivation
Instanzeigenschaften
1. hasBeenActive
2. isActive
Verwandte Seiten für HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung