IdleDetector: `requestPermission()` statische Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die requestPermission() statische Methode der IdleDetector Schnittstelle gibt ein Promise zurück, das mit einem String aufgelöst wird, wenn der Benutzer entschieden hat, ob er dem Origin den Zugriff auf ihren Ruhezustand gewähren möchte. Es wird mit "granted" bei Zustimmung und "denied" bei Ablehnung aufgelöst.

Syntax

js
IdleDetector.requestPermission()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit "granted" oder "denied" aufgelöst wird.

Sicherheit

Transiente Benutzeraktivierung ist erforderlich. Der Benutzer muss mit der Seite oder einem UI-Element interagieren, damit diese Funktion funktioniert.

Beispiele

Das folgende Beispiel verwendet ein click-Ereignis auf einem Button, um den Benutzer um Erlaubnis zu bitten, wenn er in den Ruhezustand wechselt.

js
startButton.addEventListener("click", async () => {
  if ((await IdleDetector.requestPermission()) !== "granted") {
    console.error("Idle detection permission denied.");
    return;
  }
});

Spezifikationen

Specification
Idle Detection API
# api-idledetector-requestpermission

Browser-Kompatibilität

BCD tables only load in the browser