promise-fn-retryRetry a flaky promise, the right way

A tiny, typed, isomorphic retry — exponential backoff, jitter, per-attempt timeouts, a total time budget, cancellation and polling. Zero dependencies.

Get started

Playground

GitHub

Just a function

One call — retry(fn, options). No classes, no builders. The function receives the attempt number and a per-attempt AbortSignal.

Smart waiting

Exponential backoff with a configurable factor, an optional cap, equal or full jitter, and a getDelay hook to honour Retry-After.

Bounded

Time out a single hung attempt with attemptTimeout, and cap the total time spent retrying with maxElapsedTime — not just the attempt count.

Cancellable

Pass an AbortSignal to stop pending retries, in the browser and in Node.

Selective & decisive

Decide per error with shouldRetry, or throw a BailError to give up immediately on the result.

Polls, too

Retry on the resolved value with until to wait for a condition — turning retry into a poll-until primitive.