Shared retry utilities to be used in middleware packages.
npm install @smithy/util-retry

This package provides shared utilities for retries.
By default, each client already has a default retry strategy. The default retry count is 3, and
only retryable errors will be retried.
AWS Documentation: Retry behavior.
``js
import { S3Client } from "@aws-sdk/client-s3";
const client = new S3Client({}); // default retry strategy included.
`
If you want to change the number of attempts, you can provide maxAttempts configuration during client creation.
`js
import { S3Client } from "@aws-sdk/client-s3";
const client = new S3Client({ maxAttempts: 4 });
`
This is recommended because the StandardRetryStrategy includes backoff calculation,
deciding whether an error should be retried, and a retry token counter.
If you want to change the number of attempts and use a custom delay
computation, you can use the ConfiguredRetryStrategy from @smithy/util-retry.
`js
import { S3Client } from "@aws-sdk/client-s3";
import { ConfiguredRetryStrategy } from "@smithy/util-retry";
const client = new S3Client({
retryStrategy: new ConfiguredRetryStrategy(
4, // max attempts.
(attempt: number) => 100 + attempt * 1000 // backoff function.
),
});
`
This example sets the backoff at 100ms plus 1s per attempt.
If you provide both maxAttempts and retryStrategy, the retryStrategy will
get precedence as it's more specific.
`js
import { S3Client } from "@aws-sdk/client-s3";
import { ConfiguredRetryStrategy } from "@smithy/util-retry";
const client = new S3Client({
maxAttempts: 2, // ignored.
retryStrategy: new ConfiguredRetryStrategy(
4, // used.
(attempt: number) => 100 + attempt * 1000 // backoff function.
),
});
`
You can implement the RetryStrategyV2` interface.
Source: https://github.com/smithy-lang/smithy-typescript/blob/main/packages/types/src/retry.ts
API Docs: https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-smithy-types/Interface/RetryStrategyV2/