Maintainers

| Maintainer | GitHub | Social | | ---------- | ----------------------------------------- | --------------------------------------------- | | Robin Genz | robingenz | @robin_genz |

Installation

npm install @robingenz/capacitor-badge
npx cap sync

Android Variables

This plugin will use the following project variables (defined in your app’s variables.gradle file):

• $shortcutBadgerVersion version of me.leolin:ShortcutBadger (default: 1.1.22)

Configuration

No configuration required for this plugin.

Demo

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

Usage

import { Badge } from '@robingenz/capacitor-badge';

const get = async () => {
  const result = await Badge.get();
};

const set = async (count: number) => {
  await Badge.set({ count });
};

const clear = async () => {
  await Badge.clear();
};

const checkPermissions = async () => {
  const result = await Badge.checkPermissions();
};

const requestPermissions = async () => {
  const result = await Badge.requestPermissions();
};

API

• get()
• set(...)
• increase()
• decrease()
• clear()
• isSupported()
• checkPermissions()
• requestPermissions()
• Interfaces
• Type Aliases

get()

get() => Promise<GetBadgeResult>

Get the badge count. The badge count won't be lost after a reboot or app restart.

Default: 0.

Returns: Promise<GetBadgeResult>

set(...)

set(options: SetBadgeOptions) => Promise<void>

Set the badge count.

| Param | Type | | ------------- | ----------------------------------------------------------- | | options | SetBadgeOptions |

increase()

increase() => Promise<void>

Increase the badge count.

decrease()

decrease() => Promise<void>

Decrease the badge count.

clear()

clear() => Promise<void>

Clear the badge count.

isSupported()

isSupported() => Promise<IsSupportedResult>

Check if the badge count is supported.

Returns: Promise<IsSupportedResult>

checkPermissions()

checkPermissions() => Promise<PermissionStatus>

Check permission to display badge.

Returns: Promise<PermissionStatus>

requestPermissions()

requestPermissions() => Promise<PermissionStatus>

Request permission to display badge.

Returns: Promise<PermissionStatus>

Interfaces

GetBadgeResult

| Prop | Type | | ----------- | ------------------- | | count | number |

SetBadgeOptions

| Prop | Type | | ----------- | ------------------- | | count | number |

IsSupportedResult

| Prop | Type | | ----------------- | -------------------- | | isSupported | boolean |

PermissionStatus

| Prop | Type | Description | | ------------- | ----------------------------------------------------------- | ----------------------------------------- | | display | PermissionState | Permission state of displaying the badge. |

Type Aliases

PermissionState

'prompt' | 'prompt-with-rationale' | 'granted' | 'denied'

Quirks

On Android not all launchers support badges. This plugin uses ShortcutBadger. All supported launchers are listed there.

Changelog

See CHANGELOG.md.

License

See LICENSE.