openFetchHTTP that feels native to fetch

Same request — three HTTP clients ​

The EscuelaJS categories API returns a JSON array. Below: openFetch, Axios, and ky.

openFetch — shared defaults, structured response, and room for interceptors/middleware:

import openFetch from "@hamdymohamedak/openfetch";

const res = await openFetch.get(
  "https://api.escuelajs.co/api/v1/categories"
);
// res.data, res.status, res.headers, res.config

Axios — familiar API; different transport defaults in the browser:

import axios from "axios";

const res = await axios.get(
  "https://api.escuelajs.co/api/v1/categories"
);
// res.data, res.status, res.headers, res.config

ky — minimal API on top of fetch:

import ky from "ky";

const data = await ky
  .get("https://api.escuelajs.co/api/v1/categories")
  .json();

Why developers reach for a client layer ​

• Shared configuration — baseURL, headers, timeouts, and unwrapResponse once per createClient instance.
• Cross-cutting behavior — attach auth, tracing, feature flags, and error normalization via interceptors and middleware.
• Resilience — retry policies and caching strategies without rewriting every call site.
• Predictable errors — map HTTP and network failures to typed errors instead of ad-hoc try/catch parsing.

openFetch targets teams that want those benefits while staying on fetch everywhere the platform already provides it.

Documentation ​

1. Getting started — install, default export, createClient, first requests
2. HTTP methods — GET, POST, PUT, PATCH, DELETE, request(), bodies and query params
3. React & Vue — hooks, composables, shared clients, RSC notes
4. Configuration — full request config, rawResponse, merge rules, helper exports
5. Features & request pipeline — full feature list, merge → dispatch diagrams, retry hooks
6. Plugins & fluent API — @hamdymohamedak/openfetch/plugins, @hamdymohamedak/openfetch/sugar
7. Interceptors & middleware — execution order, dispatch internals, use(), custom middleware
8. Retry & cache — retry budgets, idempotency, createCacheMiddleware, TTL / SWR
9. Errors & security — OpenFetchError, codes, guards, safe logging, assertSafeHttpUrl
10. AI assistants & skills — concise API guidance for models; SKILL.md skill bundle and skills.sh / Agent Skills format

Public API (summary) ​

Requirements ​

Node.js 18+ or any runtime with fetch and AbortController.

Source & package ​

• GitHub: openfetch-js/OpenFetch
• npm: @hamdymohamedak/openfetch

Other languages ​

Browse all translations.