Fetch middleware for client-controlled retry timing based on response status codes.
Retries transient failures using configurable backoff strategies. When a response has a retryable status code (408, 429, 500, 502, 503, 504 by default), the middleware waits according to the strategy before retrying. Unlike middleware-retry-after, retry timing is entirely client-controlled.
Intended for use with @qfetch/core.
npm install @qfetch/middleware-retry-status @proventuslabs/retry-strategies
import { withRetryStatus } from '@qfetch/middleware-retry-status';
import { withBaseUrl } from '@qfetch/middleware-base-url';
import { withResponseError } from '@qfetch/middleware-response-error';
import { exponential, upto } from '@proventuslabs/retry-strategies';
import { compose } from '@qfetch/core';
// Resilient API client with exponential backoff
const api = compose(
withResponseError(),
withRetryStatus({
// Retry up to 3 times with exponential backoff (1s, 2s, 4s)
strategy: () => upto(3, exponential(1_000, 2)),
}),
withBaseUrl('https://api.example.com/v1/'),
)(fetch);
// Automatic retry on transient failures (500, 502, 503, 504, etc.)
const data = await api('resource').then(r => r.json());
For complete API reference, examples, and type definitions, see the API documentation.