node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »



Simple JavaScript (ES6) circuit breaker wrapper for functions returning Promises. No dependencies. Just plain ES6.

Module has configurable grace period, threshold and error message. It simply wraps any function that return promise.

More information about circuit breakers: Circuit Breakers


Basic usage with defaults

const circuitBreaker = require('simple-circuit-breaker')
function callBackend(url) {
  return fetch(url)
const withCircuitBreaker = circuitBreaker(callBackend)
  .then(doSomethingWithData, handleError)

Passing configuration options


  1. asyncFn - Function that we want to guard with circuit breaker Must return a Promise
  2. gracePeriodMs - How long do we wait before retrying after switched to CLOSED state
  3. threshold - How many failures do we need to stop calling backend and start failing immediately - HALF OPEN
  4. message - This will be the error message in OPEN state
const withCircuitBreaker = circuitBreaker(callBackend, 15000, 3, 'Damn, it failed too many times!')

Default values

  • gracePeriodMs = 3000
  • threshold = 1
  • message = 'Functionality disabled due to previous errors.'