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.
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 can be used to request a lock that prevents device screens from dimming or locking when an application needs to keep running.
This interface, and hence the system wake lock, is exposed through the Navigator.wakeLock property.
Instance methods
request()-
Returns a
Promisethat fulfills with aWakeLockSentinelobject if the screen wake lock is granted.
Examples
The following code awaits the request for a WakeLockSentinel object, and continues if the request is granted.
The WakeLock.request() method is wrapped in a try...catch statement to catch cases when the promise might be rejected, such as due to low device power.
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}`);
}
Note that the screen wake lock may be revoked by the device after it has been granted.
The returned WakeLockSentinel can be used to check the status of the lock, and/or to manually cancel a held screen wake lock.
Specifications
| Specification |
|---|
| Screen Wake Lock API # the-wakelock-interface |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
WakeLock
|
|
|
|
|
|
|
|
|
|
|
|
|
request
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Partial support
- Partial support
- Has more compatibility info.