React Native Background Timer

React Native Background Timer

React Native Background Timer Emit event periodically (even when app is in the background)

React Native Background Timer

Emit event periodically (even when app is in the background).


  1. If you use Expo to create a project you'll just need to "eject".

    expo eject
  2. Install React Native Background Timer package.

    yarn add react-native-background-timer
    # or using npm
    npm install react-native-background-timer --save
  3. Link React Native Background Timer library. This step is not necessary when you use React Native >= 0.60 (and your app is not ejected from Expo).

    react-native link react-native-background-timer
  4. If you use CocoaPods or React Native >= 0.60 (and your app is not ejected from Expo) or your app is ejected from Expo, then before running your app on iOS, make sure you have CocoaPods installed and run:

    cd ios
    pod install

Link the library manually if you get errors:

  • Android: TypeError: Cannot read property 'setTimeout' of undefined or TypeError: null is not an object (evaluating 'RNBackgroundTimer.setTimeout')
  • iOS: Native module cannot be null

Android manual linking

  • android/settings.gradle

    + include ':react-native-background-timer'
    + project(':react-native-background-timer').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-background-timer/android')
  • android/app/build.gradle

    dependencies {
    +   implementation project(':react-native-background-timer')
  • android/app/src/main/java/com/your-app/

    + import com.ocetnik.timer.BackgroundTimerPackage;
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
    +   new BackgroundTimerPackage()
    ```</details> <details><summary>iOS manual linking</summary>
  • ios/Podfile

    + pod 'react-native-background-timer', :path => '../node_modules/react-native-background-timer'


import BackgroundTimer from 'react-native-background-timer';


To use the same code both on Android and iOS use runBackgroundTimer() and stopBackgroundTimer(). There can be used only one background timer to keep code consistent.

BackgroundTimer.runBackgroundTimer(() => { 
//code that will be called every 3 seconds 
//rest of code will be performing for iOS on background too

BackgroundTimer.stopBackgroundTimer(); //after this call all code on background stop run.


After iOS update logic of background task little bit changed. So we can't use as it was. You have to use only start() and stop() without parameters. And all code that is performing will continue performing on background including all setTimeout() timers.


// Do whatever you want incuding setTimeout;

If you call stop() on background no new tasks will be started! Don't call .start() twice, as it stop performing previous background task and starts new. If it will be called on backgound no tasks will run.


You can use the setInterval and setTimeout functions. This API is identical to that of react-native and can be used to quickly replace existing timers with background timers.

// Start a timer that runs continuous after X milliseconds
const intervalId = BackgroundTimer.setInterval(() => {
    // this will be executed every 200 ms
    // even when app is the the background
}, 200);

// Cancel the timer when you are done with it
// Start a timer that runs once after X milliseconds
const timeoutId = BackgroundTimer.setTimeout(() => {
    // this will be executed once after 10 seconds
    // even when app is the the background
}, 10000);

// Cancel the timeout if necessary


Obsolete usage which doesn't support multiple background timers.

import {
} from 'react-native';

import BackgroundTimer from 'react-native-background-timer';
const EventEmitter ={
  ios: () => NativeAppEventEmitter,
  android: () => DeviceEventEmitter,
// start a global timer
BackgroundTimer.start(5000); // delay in milliseconds only for Android
// listen for event
EventEmitter.addListener('backgroundTimer', () => {
    // this will be executed once after 5 seconds
// stop the timer

Download Details:

Author: ocetnik

Source Code:

react-native react mobile-apps

What is Geek Coin

What is GeekCash, Geek Token

Best Visual Studio Code Themes of 2021

Bootstrap 5 Tutorial - Bootstrap 5 Crash Course for Beginners

Nest.JS Tutorial for Beginners

Hello Vue 3: A First Look at Vue 3 and the Composition API

How native is React Native? | React Native vs Native App Development

Article covers: How native is react native?, React Native vs (Ionic, Cordova), Similarities and difference between React Native and Native App Development.

React Native App Developers India, React Native App Development Company

Hire React Native app developers India from a preferred React Native app development company by innovative industry leaders. Let's Discuss Your Project.

React Native Mobile App Development

Skenix is providing React Native Development Services with qualified React Native App Developers. Get the best React Native App Development Services.

How React Native Is Shaping Mobile App Development

Are you a mobile app developer looking for more efficient tools for your projects? Mobile app development is getting tougher and tougher as the market continues to grow. As a developer, you need to develop Apps which meet the demands of your users. To achieve this, adopt the right tools, like the React Native development framework.

Top React Native Mobile App Development Companies in USA

Looking for top React Native mobile app development company in USA for Startups & Enterprise? Find out the top list of React Native mobile app development company in USA.