react-native-background-timer-android

This library provides setTimeout and setInterval implementations that keep working even if the app is running in the background or the screen is locked.

Based on react-native-background-timer but with major code changes and only works on Android.

Features

• Clear and simple API
• Can set multiple timers
• Keeps running when the screen is locked
• Each timer has its own WakeLock that remains active while it's running
• Intervals are handled entirely on the native side
• Fault-tolerant: any exception gets reported back to JS via promises
• TypeScript declarations included

Install

yarn add react-native-background-timer-android

Usage

1import Timer from "react-native-background-timer-android";
2
3// Start a timer that will repeatedly log "tic" after 500 milliseconds
4const intervalId = Timer.setInterval(() => console.log("tic"), 500);
5
6// Cancel the timer when you are done with it
7Timer.clearInterval(intervalId);
8
9// Start a timer that will log "tic" after 500 milliseconds just once
10const timeoutId = Timer.setTimeout(() => console.log("tic"), 500);
11
12// Cancel the timer if needed
13Timer.clearTimeout(timeoutId);

API

1Timer.setInterval(callback: () => void, millis: number, onError?: (error: Error) => void): number;
2Timer.setTimeout(callback: () => void, millis: number, onError?: (error: Error) => void): number;
3Timer.clearInterval(id: number): Promise<void>;
4Timer.clearTimeout(id: number): Promise<void>;