CommunityProgramación y desarrollogithub.com

react-data-hook

Para obtener datos del servidor en componentes React + TypeScript: un hook personalizado con respuestas tipadas, estados de carga y error, cancelación de peticiones y sin actualizaciones de estado tras desmontar el componente.

¿Qué es react-data-hook?

Este skill proporciona una guía completa para implementar un hook personalizado en React y TypeScript que realice peticiones a APIs del servidor de forma robusta y tipada. La idea central es que los componentes no gestionen directamente las peticiones, sino que deleguen la lógica de fetching en un hook que gestione explícitamente tres estados: carga, error y datos. El hook utiliza `AbortController` para cancelar peticiones en curso cuando el componente se desmonta o cuando las dependencias cambian, evitando así problemas clásicos como condiciones de carrera (race conditions) y actualizaciones de estado en componentes desmontados. El skill detalla la implementación de un hook base sin dependencias externas, pero también sugiere usar bibliotecas como TanStack Query o SWR cuando ya están presentes, ya que ofrecen funcionalidades adicionales como caché y reintentos. Finalmente, proporciona una lista de verificación para asegurar que el hook cumpla con los principios de tipado, estados y cancelación, y advierte sobre errores comunes como no manejar respuestas no 2xx o dependencias inestables.

Compatible con~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 Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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 any solo 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 data mientras 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 AbortError permanece 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 de url.
  • Poner valores no estables (un objeto/array literal, un init en línea) en el arreglo de dependencias, causando un bucle infinito de refetch. Memorízalos o depende de primitivos.
  • setData ejecutándose después del desmontaje. La limpieza abort() hace que el .then tardío se corte con AbortError.
  • Ignorar respuestas no 2xx — fetch solo rechaza en fallos de red, por lo que debes verificar res.ok tú 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 AbortController cancela 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.

Individual skills in this repo

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

Skills relacionados