React Data Hook
Una guía para obtener datos del servidor en React de la manera correcta: tipada, cancelable y con los estados de carga y error manejados cada vez.
Principios
- Un componente debe renderizar estado, no orquestar la obtención de datos. Pon la petición en un hook para que el componente se mantenga declarativo.
- Siempre modela tres estados:
loading,error,data. Nunca asumas que la solicitud fue exitosa. - Cancela las peticiones en curso cuando el componente se desmonta o las entradas cambian. Una respuesta tardía que actualiza una interfaz desmontada o desactualizada es un error real (parpadeo, datos incorrectos, advertencias de React), no teórico.
- Tipa la respuesta. Un hook que devuelve
anysolo traslada el error a otra parte.
Primero: prefiere una biblioteca de datos real cuando esté presente
Si el proyecto ya usa TanStack Query (React Query) o SWR, úsala — no implementes manualmente un fetching junto a ellas. Ellas te dan caché, deduplicación, reintentos y cancelación de forma gratuita:
const { data, isLoading, error } = useQuery({
queryKey: ["article", id],
queryFn: ({ signal }) => fetchArticle(id, signal),
});
Solo construye el hook de abajo cuando el proyecto no tenga capa de datos y no quieras añadir una.
El hook tipado base (cero dependencias)
// 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(`Solicitud fallida: ${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; // esperado
setState({
status: "error",
data: null,
error: err instanceof Error ? err : new Error(String(err)),
});
});
return () => controller.abort(); // cancela al desmontar / cambio de url
}, [url]); // volver a ejecutar solo cuando cambie la identidad de la petición
return state;
}
Por qué es correcto:
- La unión discriminada hace que los estados ilegales no sean representables — no puedes leer
datamientras estáloading. AbortController+ la devolución de limpieza cancela la petición anterior antes de iniciar una nueva, eliminando la clásica condición de carrera donde las respuestas se resuelven desordenadas.- La rama
AbortErrorpermanece silenciosa, por lo que una cancelación normal nunca muestra un error.
Usándolo — renderiza los tres estados
function Article({ id }: { id: string }) {
const result = useFetch<ArticleDto>(`/api/v1/articles/${id}`);
if (result.status === "loading") return <Spinner aria-label="Cargando artículo" />;
if (result.status === "error") return <ErrorBanner message={result.error.message} />;
return <ArticleView article={result.data} />;
}
Renderizar una rama de carga y una de error no es un pulido opcional — es la diferencia entre una pantalla en blanco y una utilizable.
Errores comunes que este skill previene
useEffect(() => { fetch(url).then(r => r.json()).then(setData) }, [])— sin estado de carga, sin manejo de errores, sin cancelación, y[]ignora un cambio deurl.- Poner valores no estables (un objeto/array literal, un
initen línea) en el arreglo de dependencias, causando un bucle infinito de refetch. Memorízalos o depende de primitivos. setDataejecutándose después del desmontaje. La limpiezaabort()hace que el.thentardío se corte conAbortError.- Ignorar respuestas no 2xx —
fetchsolo rechaza en fallos de red, por lo que debes verificarres.oktú mismo.
Lista de verificación antes de dar por terminado
- El fetching vive en un hook; el componente solo lee el estado.
- Carga, error y datos están todos representados y todos renderizados.
- La respuesta está tipada (sin
any); las no 2xx se convierten en error. - Un
AbortControllercancela al desmontar y cuando las entradas cambian. - El arreglo de dependencias contiene solo valores estables que definen la petición.
- Si el proyecto tiene React Query / SWR, se usa eso en lugar de este hook.