WakeLock
Baseline
2025
Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
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 sich Bildschirme von Geräten abdunkeln oder sperren, wenn eine Anwendung weiterlaufen muss.
Dieses Interface und damit die System-Wake-Sperre wird über die Navigator.wakeLock-Eigenschaft bereitgestellt.
Instanzmethoden
request()-
Gibt ein
Promisezurück, das mit einemWakeLockSentinel-Objekt erfüllt wird, wenn die Bildschirm-Wake-Sperre gewährt wird.
Beispiele
Der folgende Code erwartet das await einer Anfrage für ein WakeLockSentinel-Objekt und fährt fort, wenn die Anfrage gewährt wird.
Die WakeLock.request()-Methode ist in eine try...catch-Anweisung eingebettet, um Fälle zu erfassen, in denen das Promise zurückgewiesen werden könnte, beispielsweise aufgrund von niedrigem Gerätestrom.
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-Wake-Sperre vom Gerät widerrufen werden kann, nachdem sie gewährt wurde. Das zurückgegebene WakeLockSentinel kann verwendet werden, um den Status der Sperre zu überprüfen und/oder um eine gehaltene Bildschirm-Wake-Sperre manuell zu beenden.
Spezifikationen
| Specification |
|---|
| Screen Wake Lock API # the-wakelock-interface |