@capacitor-community/keep-awake

Keep Awake

@capacitor-community/keep-awake

⚡️ Capacitor plugin to prevent devices from dimming or locking the screen.

Maintainers

Maintainer	GitHub	Social
Kevin Boosten	kevinboosten	@kevinboosten
Robin Genz	robingenz	@robin_genz

Installation

npm install @capacitor-community/keep-awake
npx cap sync

Configuration

No configuration required for this plugin.

Demo

A working example can be found here: robingenz/capacitor-plugin-demo

Usage

import { KeepAwake } from '@capacitor-community/keep-awake';

const keepAwake = async () => {
  await KeepAwake.keepAwake();
};

const allowSleep = async () => {
  await KeepAwake.allowSleep();
};

const isSupported = async () => {
  const result = await KeepAwake.isSupported();
  return result.isSupported;
};

const isKeptAwake = async () => {
  const result = await KeepAwake.isKeptAwake();
  return result.isKeptAwake;
};

API

• keepAwake()
• allowSleep()
• isSupported()
• isKeptAwake()
• Interfaces

keepAwake()

keepAwake() => Promise<void>

Prevent the device from dimming the screen.

---

allowSleep()

allowSleep() => Promise<void>

Allow the device to dim the screen.

---

isSupported()

isSupported() => Promise<IsSupportedResult>

Whether keep awake is supported or not.

Returns: Promise<IsSupportedResult>

---

isKeptAwake()

isKeptAwake() => Promise<IsKeptAwakeResult>

Check if the device is kept awake.

Returns: Promise<IsKeptAwakeResult>

---

Interfaces

IsSupportedResult

Prop	Type
isSupported	boolean

IsKeptAwakeResult

Prop	Type
isKeptAwake	boolean

Changelog

See CHANGELOG.md.

License

See LICENSE.

Changelog

5.0.0 (2024-04-16)

⚠ BREAKING CHANGES

• This plugin now only supports Capacitor 6.

Features

• update to Capacitor 6 (#45) (2014347)