react-heartbeat React component

Usage no npm install needed!

<script type="module">
  import reactHeartbeat from '';



Travis npm package Coveralls

React Heartbeat is a simple React Component that will call a function that you provide at a regular interval. It should stay accurate within a few milliseconds as long as you run it. React Heartbeat will continue to call the function you pass to it as long as it is rendered, to stop it, just stop rendering React Heartbeat.


To use React Heartbeat with your component, first import it:

import Heartbeat from 'react-heartbeat';

Then render it in your component’s render function:

render() {
    return (
        <Heartbeat heartbeatFunction={this.count} heartbeatInterval={1000} />

React Heartbeat accepts 2 props:

  1. heartbeatFunction: this is the function you want to call after each heartbeatInterval.
  2. heartbeatInterval: this is the time interval in milliseconds you want to be between each call to heartbeatFunction

heartbeatInterval is optional. If you do not provide this prop the default is 1000 milliseconds (1 second).

Starting/Stopping React Heartbeat

There are several ways you can manage starting and stopping React Heartbeat from calling the function you pass to it. Here is one way:

In the state of your component add a 'paused' property as a boolean.

this.state = {
  paused: true,
  timer: 0

Then in the render function set a variable using the ternary operator to 'null' if paused is true, and set it to the React Heartbeat component if paused is false. Then render this variable in your component like this:

render() {
    const heartbeat =
        this.state.paused === true ? null : (
        <Heartbeat heartbeatFunction={this.count} heartbeatInterval={50} />
    return (

For an example of React Heartbeat used in a web app see my Pomodoro Timer. The source code for this project is here. Note: this project uses React Heartbeat as a component, not as a npm module. I created React Heartbeat while developing this project, then decided to make it an npm module.

How it works.

React Heartbeat records the system time when you first call it in state, then it schedules a call to the function you provide as a prop using setTimeout at the interval you specify as a prop. When React Heartbeat calls your function, it compares the system time when it called your function to the time it should have called your function, then adjusts the next call to your function so that it will be called at twice the interval you provided from the time you first rendered React Heartbeat in your component. It continues comparing the time your function was called to the time it should have been called and making adjustments as long as you continue to render React Heartbeat in your component.

The source code for React Heartbeat is here.