@lifeomic/attempt

What is @lifeomic/attempt?

@lifeomic/attempt is an npm package designed to handle retry logic for asynchronous operations. It provides a simple and flexible way to retry operations that may fail due to transient issues, such as network errors or temporary unavailability of a service.

What are @lifeomic/attempt's main functionalities?

Basic Retry

This feature allows you to retry an asynchronous operation a specified number of times with a delay between attempts. In this example, the operation is retried up to 5 times with a 1-second delay between attempts.

const attempt = require('@lifeomic/attempt');

async function fetchData() {
  return attempt(async () => {
    // Simulate an operation that may fail
    if (Math.random() < 0.5) {
      throw new Error('Random failure');
    }
    return 'Success';
  }, {
    maxAttempts: 5,
    delay: 1000
  });
}

fetchData().then(console.log).catch(console.error);

Exponential Backoff

This feature allows you to implement exponential backoff for retrying an operation. The delay between attempts increases exponentially. In this example, the delay starts at 1 second and doubles with each subsequent attempt.

const attempt = require('@lifeomic/attempt');

async function fetchData() {
  return attempt(async () => {
    // Simulate an operation that may fail
    if (Math.random() < 0.5) {
      throw new Error('Random failure');
    }
    return 'Success';
  }, {
    maxAttempts: 5,
    delay: 1000,
    factor: 2
  });
}

fetchData().then(console.log).catch(console.error);

Custom Retry Logic

This feature allows you to define custom logic for handling errors and deciding whether to continue retrying. In this example, a custom error handler logs the error message and continues retrying.

const attempt = require('@lifeomic/attempt');

async function fetchData() {
  return attempt(async () => {
    // Simulate an operation that may fail
    if (Math.random() < 0.5) {
      throw new Error('Random failure');
    }
    return 'Success';
  }, {
    maxAttempts: 5,
    delay: 1000,
    handleError: (err, context) => {
      console.log(`Attempt ${context.attemptNumber} failed: ${err.message}`);
      return true; // Continue retrying
    }
  });
}

fetchData().then(console.log).catch(console.error);

Other packages similar to @lifeomic/attempt

retry

The 'retry' package provides similar functionality for retrying operations with customizable options. It supports exponential backoff, custom retry strategies, and more. Compared to @lifeomic/attempt, 'retry' offers a more extensive set of features and greater flexibility in defining retry strategies.

promise-retry

The 'promise-retry' package is another alternative for retrying asynchronous operations. It allows you to specify retry options such as retries, factor, minTimeout, and maxTimeout. 'promise-retry' is similar to @lifeomic/attempt but focuses specifically on promise-based operations and provides a straightforward API for retry logic.

async-retry

The 'async-retry' package is designed for retrying asynchronous functions with customizable retry strategies. It supports exponential backoff, custom retry conditions, and more. 'async-retry' is comparable to @lifeomic/attempt in terms of functionality but offers additional features like custom retry conditions and more granular control over retry behavior.

README

The README file is missing