Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Asynchronous periodic polling with promise.

**Photo by [Icons8 team]( on [Unsplash](**

NPM Version Downloads CircleCI Status Known Vulnerabilities Maintainability Netlify Status

What is "periodic promise"?

It's a lightweight library that answers the following need:

  • resolving a Promise at specified intervals (in milliseconds)
  • calling a callback after every cycle exposing the response of the Promise
  • externally breaking the cycle
  • defining a specified number of iterations

Promises are a JavaScript feature that allow you to defer further actions until after a previous action has completed, or respond to its failure.

How to get it


npm install periodic-promise


yarn add periodic-promise


Usage in a nutshell

This code will call every 2 seconds the "foo.api()" until the response will return "bar".

(async () => {
  const callback = r => r === 'bar';
  await periodicPromise(2000, () => foo.api(), callback)

This example will do the same, but it will perform only 20 iterations.

(async () => {
  const callback = r => r === 'bar';
  await periodicPromise(2000, () => foo.api(), callback, 20)

Live example:

See the live example:



periodicPromise(delay, action, callback, limit);

Parameter values

Parameter Description Default value
delay Required. The intervals in milliseconds on how often to execute the code. ( > 0) N/A
action Required. The function that will be executed. N/A
callback Required. The function that will be call after every execution with the response of "action" as first param. If the returned value is truthy, the execution will continue. If the returned value is falsy, the execution will be stopped. N/A
limit Optional. After how many times the execution will be stopped. undefined (no limit)

📝 Documentation

🚨 Tests

Run your unit tests once:

npm run test

or in watch mode:

npm run test:watch

👷 Build

Build the library:

npm run build

🚀 Dev mode

In dev mode, you can build in real-time your changes:

npm run dev


I'm sure you'll find bugs and when you do it would be great if you'd could report them here.

💪 Contribution

The project is still in its early stages and in progress. I think there's no need for guidelines yet, so feel free to contribute or give feedback as you prefer.

©️ License