circuit-breaker-js

Hystrix-like circuit breaker for JavaScript.

CircuitBreaker

Hystrix-like circuit breaker for JavaScript.

var breaker = new CircuitBreaker();
 
var command = function(successfailed) {
  restCall()
    .done(success)
    .fail(failed);
};
 
var fallback = function() {
  alert("Service is down");
};
 
breaker.run(command, fallback);

Create a new instance of a circuit breaker. Accepts the following config options:

Duration of statistical rolling window in milliseconds. This is how long metrics are kept for the circuit breaker to use and for publishing.

The window is broken into buckets and "roll" by those increments.

Default Value: 10000

Number of buckets the rolling statistical window is broken into.

Default Value: 10

Time in milliseconds after which a command will timeout.

Default Value: 3000

Error percentage at which the circuit should trip open and start short-circuiting requests to fallback logic.

Default Value: 50

Minimum number of requests in rolling window needed before tripping the circuit will occur.

For example, if the value is 20, then if only 19 requests are received in the rolling window (say 10 seconds) the circuit will not trip open even if all 19 failed.

Default Value: 5

Function that is run whenever the circuit is opened (i.e. the threshold is reached). Receives the metrics for the current window as an argument.

Default Value: no-op

Function that is run whenever the circuit is closed (i.e. the service is back up). Receives the metrics for the current window as an argument.

Default Value: no-op

Runs a command if circuit is closed, otherwise defaults to a fallback if provided. The command is called with success and failure handlers which you need to call at the appropriate point in your command. For example, if an ajax request succeeds the the success function should be called to notify the breaker. If neither success or failed are called then the command it's assumed the command timed out.

Checks whether the breaker is currently accepting requests.

Forces the circuit to open.

Metrics will not be collected while the circuit is forced.

Forces the circuit to close.

Metrics will not be collected while the circuit is forced.

Returns the circuit to its last unforced state.

Install the dependencies

npm install

Run the tests with:

grunt test

or

grunt test:browser