WakeLock
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The WakeLock
interface of the Screen Wake Lock API prevents device screens from dimming or locking when an application needs to keep running.
The system wake lock is exposed through the global Navigator.wakeLock
property.
Instance methods
request()
-
Requests a
WakeLockSentinel
object, which returns aPromise
that resolves with aWakeLockSentinel
object.
Examples
The following asynchronous function requests a WakeLockSentinel
object. The WakeLock.request()
method is wrapped in a try...catch
statement to account for if the browser refuses the request for any reason.
js
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}`);
}
Specifications
Specification |
---|
Screen Wake Lock API # the-wakelock-interface |
Browser compatibility
BCD tables only load in the browser