CommunityCodierung & Entwicklunggithub.com

react-data-hook

Verwendung beim Abrufen von Serverdaten in einer React + TypeScript-Komponente – Erstellen oder Überprüfen eines benutzerdefinierten Data-Fetching-Hooks mit typisierten Antworten, Lade-/Fehlerzuständen, Request-Abbruch und ohne Zustandsaktualisierungen nach dem Unmount. Ersetzt ad-hoc useEffect + fetch.

Was ist react-data-hook?

Diese Skill-Anleitung definiert ein bewährtes Muster zum Datenabruf in React-Komponenten mit TypeScript. Sie stellt sicher, dass Fetching-Logik in einen benutzerdefinierten Hook ausgelagert wird, der drei Zustände (Laden, Fehler, Daten) modelliert, Antworten typisiert und Request-Abbruch mittels AbortController unterstützt, um Nebenläufigkeitsprobleme zu vermeiden. Der Skill empfiehlt, wo möglich, etablierte Bibliotheken wie TanStack Query oder SWR zu verwenden, und liefert andernfalls eine vollständig getypte, auf `useEffect` basierende `useFetch`-Implementierung mit diskriminierter Union, die ungültige Zustände ausschließt. Enthalten ist eine Checkliste, die gängige Fehler verhindert, darunter fehlende Fehlerbehandlung, nicht gecancelte Requests beim Unmount und Typunsicherheit.

Funktioniert mit~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 Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

React Data Hook

Ein Playbook für den korrekten Datenabruf von Servern in React: typisiert, abbrechbar und mit Lade- + Fehlerzuständen, die jedes Mal behandelt werden.

Prinzipien

  • Eine Komponente sollte Zustände rendern, nicht das Abrufen orchestrieren. Lagere das Fetching in einen Hook aus, damit die Komponente deklarativ bleibt.
  • Modelliere immer drei Zustände — loading, error, data. Gehe nie davon aus, dass die Anfrage erfolgreich war.
  • Breche laufende Anfragen ab, wenn die Komponente unmountet oder sich die Eingaben ändern. Eine späte Antwort, die eine unmountete oder veraltete UI aktualisiert, ist ein echter Fehler (Flackern, falsche Daten, React-Warnungen), kein theoretischer.
  • Typisiere die Antwort. Ein Hook, der any zurückgibt, verschiebt den Fehler nur nachgelagert.

Erstens: Bevorzuge eine echte Datenbibliothek, falls vorhanden

Wenn das Projekt bereits TanStack Query (React Query) oder SWR verwendet, nutze es — führe kein handgemachtes Fetching daneben ein. Diese bieten Caching, Deduplizierung, Wiederholungsversuche und Request-Abbruch kostenlos:

const { data, isLoading, error } = useQuery({
  queryKey: ["article", id],
  queryFn: ({ signal }) => fetchArticle(id, signal),
});

Baue den untenstehenden Hook nur dann, wenn das Projekt keine Datenebene hat und du keine hinzufügen möchtest.

Der grundlegende typisierte Hook (keine Abhängigkeiten)

// 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; // expected
        setState({
          status: "error",
          data: null,
          error: err instanceof Error ? err : new Error(String(err)),
        });
      });

    return () => controller.abort(); // abbrechen bei Unmount / URL-Änderung
  }, [url]); // nur neu ausführen, wenn sich die Request-Identität ändert

  return state;
}

Warum es korrekt ist:

  • Die diskriminierte Union macht ungültige Zustände unmöglich darstellbar — du kannst data nicht lesen, während loading aktiv ist.
  • AbortController + die Cleanup-Rückgabe bricht den vorherigen Request ab, bevor ein neuer gestartet wird, und beseitigt den klassischen Race-Condition, bei dem Antworten in falscher Reihenfolge eintreffen.
  • Der AbortError-Zweig bleibt still, sodass ein normaler Abbruch nie einen Fehler anzeigt.

Verwendung – alle drei Zustände rendern

function Article({ id }: { id: string }) {
  const result = useFetch<ArticleDto>(`/api/v1/articles/${id}`);

  if (result.status === "loading") return <Spinner aria-label="Lade Artikel" />;
  if (result.status === "error") return <ErrorBanner message={result.error.message} />;

  return <ArticleView article={result.data} />;
}

Einen Lade- und einen Fehlerzweig zu rendern, ist kein optionaler Feinschliff – es ist der Unterschied zwischen einem leeren Bildschirm und einem nutzbaren.

Häufige Fehler, die dieser Skill verhindert

  • useEffect(() => { fetch(url).then(r => r.json()).then(setData) }, []) — kein Ladezustand, keine Fehlerbehandlung, kein Request-Abbruch, und [] ignoriert eine sich ändernde url.
  • Nicht-stabile Werte (ein Objekt-/Array-Literal, ein Inline-init) in das Abhängigkeitsarray aufnehmen, was eine Endlosschleife von Neuanfragen verursacht. Memoisiere sie oder verwende primitive Werte.
  • setData feuert nach dem Unmount. Der Cleanup-abort() bewirkt, dass das spätere .then bei einem AbortError frühzeitig abbricht.
  • Nicht-2xx-Antworten verschlucken – fetch lehnt nur bei Netzwerkfehlern ab, also musst du res.ok selbst prüfen.

Checkliste, bevor du es als erledigt betrachtest

  • Das Fetching lebt in einem Hook; die Komponente liest nur den Zustand.
  • Laden, Fehler und Daten sind alle dargestellt und werden alle gerendert.
  • Die Antwort ist typisiert (kein any); Nicht-2xx wird in einen Fehler umgewandelt.
  • Ein AbortController bricht beim Unmount und bei Änderungen der Eingaben ab.
  • Das Abhängigkeitsarray enthält nur stabile Werte, die den Request definieren.
  • Wenn das Projekt React Query / SWR hat, wird dieses anstelle dieses Hooks verwendet.

Individual skills in this repo

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

Verwandte Skills