React Data Hook
Un guide pour récupérer correctement des données serveur dans React : typé, annulable, et avec gestion systématique des états de chargement et d'erreur.
Principes
- Un composant doit rendre un état, pas orchestrer la récupération. Placez l'
fetchdans un hook pour que le composant reste déclaratif. - Modélisez toujours trois états —
loading,error,data. Ne présumez jamais que la requête a réussi. - Annulez les requêtes en vol lorsque le composant se démonte ou que les entrées changent. Une réponse tardive qui met à jour une UI démontée ou obsolète est un vrai bug (scintillement, mauvaises données, avertissements React), pas un bug théorique.
- Typez la réponse. Un hook qui retourne
anyne fait que déplacer le bug en aval.
Premièrement : privilégier une vraie bibliothèque de données lorsqu'elle est présente
Si le projet utilise déjà TanStack Query (React Query) ou SWR, utilisez-les — ne codez pas un hook à la main à côté. Ils offrent gratuitement mise en cache, déduplication, tentatives et annulation :
const { data, isLoading, error } = useQuery({
queryKey: ["article", id],
queryFn: ({ signal }) => fetchArticle(id, signal),
});
Construisez le hook ci-dessous uniquement lorsque le projet n'a pas de couche de données et que vous ne souhaitez pas en ajouter une.
Le hook typé de base (zéro dépendance)
// useFetch.ts
import { useEffect, useState } from "react";
type State<T> =
| { status: "loading"; data: null; error: null }
| { status: "success"; data: T; error: null }
| { status: "error"; data: null; error: Error };
export function useFetch<T>(url: string, init?: RequestInit): State<T> {
const [state, setState] = useState<State<T>>({
status: "loading",
data: null,
error: null,
});
useEffect(() => {
const controller = new AbortController();
setState({ status: "loading", data: null, error: null });
fetch(url, { ...init, signal: controller.signal })
.then(async (res) => {
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
return (await res.json()) as T;
})
.then((data) => setState({ status: "success", data, error: null }))
.catch((err: unknown) => {
if (err instanceof DOMException && err.name === "AbortError") return; // attendu
setState({
status: "error",
data: null,
error: err instanceof Error ? err : new Error(String(err)),
});
});
return () => controller.abort(); // annuler lors du démontage / changement d'URL
}, [url]); // ré-exécuter uniquement lorsque l'identité de la requête change
return state;
}
Pourquoi c'est correct :
- L'union discriminée rend les états illégaux non représentables — vous ne pouvez pas lire
datapendant leloading. AbortController+ le retour de nettoyage annule la requête précédente avant d'en lancer une nouvelle, éliminant la classique course où les réponses arrivent dans le désordre.- La branche
AbortErrorreste silencieuse, donc une annulation normale ne provoque jamais d'erreur affichée.
L'utiliser — rendre les trois états
function Article({ id }: { id: string }) {
const result = useFetch<ArticleDto>(`/api/v1/articles/${id}`);
if (result.status === "loading") return <Spinner aria-label="Chargement de l'article" />;
if (result.status === "error") return <ErrorBanner message={result.error.message} />;
return <ArticleView article={result.data} />;
}
Afficher une branche de chargement et une branche d'erreur n'est pas un raffinement optionnel — c'est la différence entre un écran vide et un écran utilisable.
Erreurs courantes que ce skill évite
useEffect(() => { fetch(url).then(r => r.json()).then(setData) }, [])— pas d'état de chargement, pas de gestion d'erreur, pas d'annulation, et[]ignore un changement d'url.- Placer des valeurs non stables (un littéral objet/tableau, un
initen ligne) dans le tableau de dépendances, provoquant une boucle de récupération infinie. Mémorisez-les ou dépendez de primitives. setDatadéclenché après le démontage. Lecleanupavecabort()fait court-circuiter le.thentardif avecAbortError.- Ignorer les réponses non-2xx —
fetchne rejette qu'en cas d'échec réseau, vous devez donc vérifierres.okvous-même.
Liste de vérification avant de considérer la tâche terminée
- La récupération vit dans un hook ; le composant lit seulement l'état.
- Les états de chargement, d'erreur et de données sont tous représentés et tous rendus.
- La réponse est typée (pas de
any) ; les réponses non-2xx sont transformées en erreur. - Un
AbortControllerannule lors du démontage et lorsque les entrées changent. - Le tableau de dépendances contient uniquement des valeurs stables qui définissent la requête.
- Si le projet possède React Query / SWR, il est utilisé à la place de ce hook.