Troubleshooting

What to check when wake lock does not stick

Most wake-lock problems come down to browser support, page visibility, or device power rules. This guide covers the fastest checks first.

The button starts, but the lock is rejected

If the page reports that wake lock is unavailable or blocked, the browser may not support it in the current context. Verify that you are using localhost or HTTPS and that the browser actually supports the API on your platform.

The timer starts, then stops later

A later interruption often means the tab was hidden, the device entered a stricter power-saving mode, or the browser reclaimed the wake lock after a visibility change. This is why NoSleepScreen tries to request wake lock again when the page becomes visible, but some devices will still require a fresh user interaction.

The page works on desktop but not mobile

Mobile operating systems are more aggressive about battery protection. Foreground requirements, battery saver, and device-specific behavior can all change whether wake lock remains active. Shorter sessions usually behave more reliably.

What to do next

  • Reload the page and start a fresh session
  • Keep only the NoSleepScreen tab visible during the test
  • Use a desktop Chromium browser to confirm the core flow
  • Read the compatibility guide if the issue appears browser-specific
  • Use shorter timers on mobile devices