Prevent display sleep and enable wake lock in any Android or iOS web browser
npm install @marsgames/nosleep.jsPrevent display sleep and enable wake lock in all Android and iOS web browsers.
This package is published to npm as @marsgames/nosleep.js and can be installed with:
pnpm install @marsgames/nosleep.js
Install all development dependencies with:
pnpm install
To build this library run:
pnpm run build
The library is distributed as a modern ES Module (ESM).
``javascript
// Import as an ES Module
import NoSleep from '@marsgames/nosleep.js';
// Create a new NoSleep instance.
// By default, it attempts to use the native Wake Lock API first.
const noSleep = new NoSleep();
// Optional: To force the deprecated video-based fallback method, use:
// const noSleepFallback = new NoSleep(false);
`
To enable wake lock:
NOTE: This function call must be wrapped in a user input event handler e.g. a mouse or touch handler*
`javascript
// Enable wake lock.
// (must be wrapped in a user input event handler e.g. a mouse or touch handler)
document.addEventListener('click', function enableNoSleep() {
document.removeEventListener('click', enableNoSleep, false);
// Asynchronous call required for the Wake Lock API
noSleep.enable()
.then(() => console.log('NoSleep is active!'))
.catch((error) => console.error('NoSleep failed to activate:', error));
}, false);
`
To disable wake lock:
`javascript``
// Disable wake lock at some point in the future.
// (does not need to be wrapped in any user input event handler)
noSleep.disable();
If you find any bugs or issues please report them on the NoSleep.js Issue Tracker.
If you would like to contribute to this project please consider forking this repo, making your changes and then creating a new Pull Request back to the main code repository.
Original author: MIT. Copyright (c) Rich Tibbett.
See the LICENSE file.