cockatiel - npm Package Versions

breaking: reactor: introduce a separate BackoffFactory interface for the first backoff

This only requires changes if you use retry policies in your own code, outside of the Policy.retry().

See #30. For some backoff policies, such as delegate and exponential policies, the first backoff was always 0, before next() was called. This is undesirable, and fixing it involved separating the backoff factory from the backoff itself.

The backoff classes, such as DelegateBackoff and ExponentialBackoff, now only have a next() method. The duration, which is now a property instead of a method, is only available after the first next() call.

For example, previously if you did this:

let backoff = new ExponentialBackoff();
while (!succeeded) {
  if (!tryAgain()) {
    await delay(backoff.duration());
    backoff = backoff.next();
  }
}

You now need to call next() before you access duration:

let backoff = new ExponentialBackoff();
while (!succeeded) {
  if (!tryAgain()) {
    backoff = backoff.next();
    await delay(backoff.duration);
  }
}

Note: if you use typescript, you will need another variable for it to understand you. Here's an example of how we use it inside the RetryPolicy.