react-data-hook

Utilisé lors de la récupération de données serveur dans un composant React + TypeScript — écrire ou réviser un hook personnalisé de récupération de données avec réponses typées, état de chargement/erreur, annulation de requête et absence de mise à jour d'état après démontage.

Qu'est-ce que react-data-hook ?

Ce skill fournit une approche structurée pour récupérer des données serveur dans React en utilisant un hook personnalisé typé, annulable, et gérant correctement les états de chargement et d'erreur. Il évite les pièges courants comme les appels `useEffect + fetch` non nettoyés, les états manquants, ou les réponses décalées après démontage du composant. Le skill met en avant l'utilisation d'un `AbortController` pour annuler les requêtes en vol, et propose un hook générique `useFetch` qui expose une union discriminée pour les états `loading`, `success`, et `error`. Pour les projets utilisant déjà TanStack Query ou SWR, il recommande de les utiliser à la place. Le skill est destiné à des développeurs React et TypeScript désirant implémenter une gestion de données fiable sans dépendance externe. Il couvre la rédaction, la révision, et le remplacement de code existant basé sur `useEffect` et `fetch`.

Compatible avec~Claude Code~Codex CLI~Cursor
Part ofReact
npx skills add https://github.com/karthik1210100/agent-skills/tree/main/skills/react-data-hook

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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'fetch dans 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 any ne 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 data pendant le loading.
  • 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 AbortError reste 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 init en ligne) dans le tableau de dépendances, provoquant une boucle de récupération infinie. Mémorisez-les ou dépendez de primitives.
  • setData déclenché après le démontage. Le cleanup avec abort() fait court-circuiter le .then tardif avec AbortError.
  • Ignorer les réponses non-2xx — fetch ne rejette qu'en cas d'échec réseau, vous devez donc vérifier res.ok vous-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 AbortController annule 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.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés