WakeLockSentinel
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.
Die WakeLockSentinel-Schnittstelle der Screen Wake Lock API kann verwendet werden, um den Status der Plattform-Bildschirmwachschaltung zu überwachen und bei Bedarf den Lock manuell zu lösen.
Die Bildschirmwachschaltung verhindert, dass Geräteschirme gedimmt oder gesperrt werden, wenn eine Anwendung weiterlaufen muss.
Ein Bildschirm-Wachschaltung wird mit der Methode navigator.wakeLock.request() angefordert, die ein Promise zurückgibt, das mit einem WakeLockSentinel-Objekt erfüllt wird, wenn der Lock gewährt wird.
Ein erworbener Bildschirm-Wachschaltung kann manuell über die Methode release() oder automatisch über die Plattform-Bildschirmwachschaltung gelöst werden. Letzteres kann geschehen, wenn das Dokument inaktiv wird oder die Sichtbarkeit verliert, wenn das Gerät wenig Strom hat oder der Benutzer den Energiesparmodus aktiviert.
Ein freigegebener WakeLockSentinel kann nicht wiederverwendet werden: Ein neuer Sentinel muss mit navigator.wakeLock.request() angefordert werden, wenn ein neuer Lock benötigt wird.
Das Freigeben aller WakeLockSentinel-Instanzen eines bestimmten Typs von Wachschaltung führt dazu, dass der zugrunde liegende Plattform-Lock gelöst wird.
Ein Ereignis wird an den WakeLockSentinel ausgelöst, wenn der Plattform-Lock gelöst wird, sodass Anwendungen ihre Benutzeroberfläche entsprechend konfigurieren und, falls erforderlich, den Lock erneut anfordern können.
Instanzeigenschaften
Erbt auch Eigenschaften von seiner Elternschnittstelle, EventTarget.
releasedSchreibgeschützt-
Gibt einen Booleschen Wert zurück, der anzeigt, ob der
WakeLockSentinelfreigegeben wurde. typeSchreibgeschützt-
Gibt eine Zeichenkettenrepräsentation des derzeit erworbenen
WakeLockSentinel-Typs zurück. Rückgabewerte sind:screen: Eine Bildschirm-Wachschaltung. Verhindert, dass Geräte den Bildschirm dimmen oder sperren.
Instanzmethoden
Erbt auch Methoden von seiner Elternschnittstelle, EventTarget.
Ereignisse
Beispiele
In diesem Beispiel erstellen wir eine asynchrone Funktion, die einen WakeLockSentinel anfordert.
Sobald die Bildschirm-Wachschaltung erlangt ist, lauschen wir dem release-Ereignis, das verwendet werden kann, um entsprechendes UI-Feedback zu geben.
Der Sentinel kann durch entsprechende Interaktionen erworben oder freigegeben werden.
// create a reference for the wake lock
let wakeLock = null;
// create an async function to request a wake lock
const requestWakeLock = async () => {
try {
wakeLock = await navigator.wakeLock.request("screen");
// listen for our release event
wakeLock.addEventListener("release", () => {
// if wake lock is released alter the UI accordingly
});
} catch (err) {
// if wake lock request fails - usually system related, such as battery
}
};
wakeLockOnButton.addEventListener("click", () => {
requestWakeLock();
});
wakeLockOffButton.addEventListener("click", () => {
if (wakeLock !== null) {
wakeLock.release().then(() => {
wakeLock = null;
});
}
});
Spezifikationen
| Specification |
|---|
| Screen Wake Lock API # the-wakelocksentinel-interface |
Browser-Kompatibilität
Loading…