WakeLockSentinel: release Ereignis

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 release-Ereignis der WakeLockSentinel-Schnittstelle wird ausgelöst, wenn der Handle des Sentinel-Objekts freigegeben wurde.

Ein WakeLockSentinel kann manuell über die release()-Methode oder automatisch über die Plattform-Wachsamkeitssperre freigegeben werden. Dies kann passieren, wenn das Dokument inaktiv wird oder die Sichtbarkeit verliert, wenn das Gerät wenig Strom hat oder der Benutzer den Energiesparmodus aktiviert.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

js
addEventListener("release", (event) => { })

onrelease = (event) => { }

Ereignistyp

Ein generisches Event.

Beispiele

Dieses Beispiel aktualisiert die Benutzeroberfläche, wenn die Wachsamkeitssperre freigegeben wird.

js
wakeLock.addEventListener("release", () => {
  // if wake lock is released alter the UI accordingly
  statusElement.textContent = "Wake Lock has been released";
});

Spezifikationen

Specification
Screen Wake Lock API
# the-onrelease-attribute

Browser-Kompatibilität

Siehe auch