UserActivation

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.

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 wird nicht in Worker-Umgebungen offengelegt.

Instanz-Eigenschaften

UserActivation.hasBeenActive Nur lesbar

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

UserActivation.isActive Nur lesbar

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

Beschreibung

Ein Objekt dieses Typs wird über die Eigenschaft navigator.userActivation abgerufen 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 dass er seit dem Laden der Seite eine Interaktion abgeschlossen hat. Die Benutzeraktivierung kann durch einen Klick auf eine Schaltfläche, eine Berührung mit dem Zeiger oder eine andere Benutzerinteraktion mit der Seite ausgelöst werden.

Es gibt zwei Arten von Benutzeraktivierungszuständen im Fenster:

Weitere Informationen und eine Liste von APIs, die entweder eine dauerhafte oder vorübergehende Benutzeraktivierung erfordern, finden Sie unter Features, die durch Benutzeraktivierung gesperrt sind.

Beispiele

Überprüfen, ob kürzlich eine Benutzerinteraktion stattgefunden hat

Verwenden Sie navigator.userActivation, um auf das UserActivation-Objekt zuzugreifen, und dann UserActivation.isActive, um zu überprü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 Benutzerinteraktion stattgefunden hat

Verwenden Sie UserActivation.hasBeenActive, um zu überprü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
}

Spezifikationen

Specification
HTML Standard
# the-useractivation-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch