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 einemWakeLockSentinel
-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.
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