https://github.com/ofershap/tiny-retry
Retry async functions with exponential backoff. Drop-in p-retry replacement. ESM + CJS, zero deps, TypeScript.
https://github.com/ofershap/tiny-retry
Last synced: 3 months ago
JSON representation
Retry async functions with exponential backoff. Drop-in p-retry replacement. ESM + CJS, zero deps, TypeScript.
- Host: GitHub
- URL: https://github.com/ofershap/tiny-retry
- Owner: ofershap
- License: mit
- Created: 2026-03-05T19:21:49.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-19T00:45:49.000Z (3 months ago)
- Last Synced: 2026-03-19T14:16:58.551Z (3 months ago)
- Language: TypeScript
- Size: 872 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# tiny-retry
[](https://www.npmjs.com/package/tiny-pretry)
[](https://www.npmjs.com/package/tiny-pretry)
[](https://github.com/ofershap/tiny-retry/actions/workflows/ci.yml)
[](https://www.typescriptlang.org/)
[](https://opensource.org/licenses/MIT)
Retry async functions with exponential backoff. Same API as [`p-retry`](https://github.com/sindresorhus/p-retry), but ships both ESM and CJS with zero dependencies.
```ts
import { pRetry } from "tiny-pretry";
const data = await pRetry(
() => fetch("https://api.example.com/data").then((r) => r.json()),
{ retries: 3 },
);
```
> ~800 bytes gzipped. Zero dependencies. Replaces p-retry without the ESM-only headache.
Demo built with remotion-readme-kit
## Install
```bash
npm install tiny-pretry
```
## Usage
```ts
import { pRetry } from "tiny-pretry";
const result = await pRetry(
async (attemptNumber) => {
console.log(`Attempt ${attemptNumber}`);
const res = await fetch("https://api.example.com");
if (!res.ok) throw new Error(res.statusText);
return res.json();
},
{ retries: 5 },
);
```
### Stop retrying early
```ts
import { pRetry, AbortError } from "tiny-pretry";
await pRetry(
async () => {
const res = await fetch("https://api.example.com");
if (res.status === 401) {
throw new AbortError("Not authorized, retrying won't help");
}
return res.json();
},
{ retries: 5 },
);
```
### Track failed attempts
```ts
await pRetry(doWork, {
retries: 5,
onFailedAttempt: (error) => {
console.log(
`Attempt ${error.attemptNumber} failed. ${error.retriesLeft} retries left.`,
);
},
});
```
### Cancel with AbortSignal
```ts
const controller = new AbortController();
setTimeout(() => controller.abort(), 10000);
await pRetry(unreliableCall, {
retries: 10,
signal: controller.signal,
});
```
## Differences from `p-retry`
`p-retry` v6+ is ESM-only. If you `require("p-retry")` in a CommonJS project, you get `ERR_REQUIRE_ESM`. `tiny-retry` works with both `import` and `require()`.
| | `p-retry` | `tiny-retry` |
| ------------ | --------------------------- | ------------ |
| CJS support | v5 only (v6+ ESM-only) | ESM + CJS |
| Dependencies | `retry`, `is-network-error` | 0 |
| TypeScript | separate @types | native |
| Export | default | named |
## Migrating from p-retry
```diff
- import pRetry from "p-retry";
+ import { pRetry } from "tiny-pretry";
```
One line. Everything else stays the same.
## API
### `pRetry(fn, options?)`
Retries `fn` until it succeeds or retries are exhausted.
- `fn(attemptNumber)` - function to retry (attempt starts at 1)
- `options.retries` - max retries (default: `10`)
- `options.factor` - exponential factor (default: `2`)
- `options.minTimeout` - initial delay in ms (default: `1000`)
- `options.maxTimeout` - max delay cap in ms (default: `Infinity`)
- `options.randomize` - add jitter to delays (default: `false`)
- `options.signal` - `AbortSignal` for cancellation
- `options.onFailedAttempt(error)` - called after each failure
### `AbortError`
Throw `new AbortError(message)` or `new AbortError(error)` inside `fn` to stop retrying immediately.
### `FailedAttemptError`
The error passed to `onFailedAttempt` has two extra properties:
- `attemptNumber` - which attempt just failed (1-based)
- `retriesLeft` - how many retries remain
## The tiny-\* family
Drop-in replacements for sindresorhus async utilities. All ship ESM + CJS with zero dependencies.
| Package | Replaces | What it does |
| ------------------------------------------------------ | -------------------- | ------------------------------ |
| [tiny-limit](https://github.com/ofershap/tiny-limit) | p-limit | Concurrency limiter |
| [tiny-map](https://github.com/ofershap/tiny-map) | p-map | Concurrent map with order |
| **tiny-retry** | p-retry | Retry with exponential backoff |
| [tiny-queue](https://github.com/ofershap/tiny-queue) | p-queue | Priority task queue |
| [tiny-ms](https://github.com/ofershap/tiny-ms) | ms | Parse/format durations |
| [tiny-escape](https://github.com/ofershap/tiny-escape) | escape-string-regexp | Escape regex chars |
Want all async utilities in one import? Use [`tiny-pasync`](https://github.com/ofershap/tiny-async).
## Author
[](https://gitshow.dev/ofershap)
[](https://linkedin.com/in/ofershap)
[](https://github.com/ofershap)
---
If this saved you from `ERR_REQUIRE_ESM`, [star the repo](https://github.com/ofershap/tiny-retry) or [open an issue](https://github.com/ofershap/tiny-retry/issues) if something breaks.
---
README built with [README Builder](https://ofershap.github.io/readme-builder/)
## License
[MIT](LICENSE) © [Ofer Shapira](https://github.com/ofershap)