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
anyzurü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
datanicht lesen, währendloadingaktiv 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 änderndeurl.- 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. setDatafeuert nach dem Unmount. Der Cleanup-abort()bewirkt, dass das spätere.thenbei einemAbortErrorfrühzeitig abbricht.- Nicht-2xx-Antworten verschlucken –
fetchlehnt nur bei Netzwerkfehlern ab, also musst dures.okselbst 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
AbortControllerbricht 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.