DasWakeLock-Interface derScreen 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 dieNavigator.wakeLock-Eigenschaft bereitgestellt.

Instanzmethoden

request()

Gibt einPromise zurück, das mit einemWakeLockSentinel-Objekt erfüllt wird, wenn die Bildschirm-Wake-Sperre gewährt wird.

Beispiele

Der folgende Code erwartet dasawait einer Anfrage für einWakeLockSentinel-Objekt und fährt fort, wenn die Anfrage gewährt wird.

DieWakeLock.request()-Methode ist in einetry...catch-Anweisung eingebettet, umFä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ückgegebeneWakeLockSentinel kann verwendet werden, um den Status der Sperre zu überprüfen und/oder um eine gehaltene Bildschirm-Wake-Sperre manuell zu beenden.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Wach bleiben mit der Screen Wake Lock API