WakeLock

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

Das WakeLock-Interface der Screen Wake Lock API kann verwendet werden, um eine Sperre anzufordern, die verhindert, dass Geräteschirme abdimmen oder gesperrt werden, wenn eine Anwendung weiterlaufen muss.

Dieses Interface und damit die System-Wach-Sperre wird über die Navigator.wakeLock-Eigenschaft bereitgestellt.

Instanzmethoden

request()

Gibt ein Promise zurück, das mit einem WakeLockSentinel-Objekt erfüllt wird, wenn die Bildschirm-Wach-Sperre gewährt wird.

Beispiele

Der folgende Code await die Anforderung eines WakeLockSentinel-Objekts und fährt fort, wenn die Anforderung gewährt wird.

Die Methode WakeLock.request() ist in einer try...catch-Anweisung eingeschlossen, um Fälle zu erfassen, in denen das Promise abgelehnt werden könnte, wie z.B. aufgrund eines niedrigen Gerätestroms.

js
try {
  const wakeLock = await navigator.wakeLock.request("screen");
} catch (err) {
  // the wake lock request fails - usually system related, such being low on battery
  console.log(`${err.name}, ${err.message}`);
}

Beachten Sie, dass die Bildschirm-Wach-Sperre vom Gerät widerrufen werden kann, nachdem sie gewährt wurde. Der zurückgegebene WakeLockSentinel kann verwendet werden, um den Status der Sperre zu überprüfen und/oder um eine gehaltene Bildschirm-Wach-Sperre manuell aufzuheben.

Spezifikationen

Specification
Screen Wake Lock API
# the-wakelock-interface

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch