quick-fetch

Zero‑dependency fetch wrapper with built‑in timeout, retries (exponential back‑off with jitter), optional in‑memory caching, and a unified FetchError.

Installation

npm install @painsel/quick-fetch

Current version: 1.0.5

Usage

import { qfetch } from 'quick-fetch';
const { request, getJSON, postJSON, getText } = qfetch;

// GET with caching and retries
const data = await getJSON('https://api.example.com/data', { useCache: true, retries: 3 });

// POST JSON payload
const result = await postJSON('https://api.example.com/submit', { name: 'Alice' });

// Plain‑text fetch
const text = await getText('https://example.com/page');

API

• request(url, options) – Core fetch with timeout, retries, jitter, and caching.
• getJSON(url, options) – Convenience wrapper returning response.json().
• postJSON(url, payload, options) – POST JSON payload and parse response.
• getText(url, options) – Returns raw text.
• FetchError – Custom error exposing url, response, status, and native cause.

Features

• Works in browsers and Node ≥ 18 (native fetch).
• No external dependencies – single‑file module.
• Flexible retry condition via retryCondition callback.
• Optional caching for idempotent GET requests.

License

MIT