react-data-hook

Use ao buscar dados do servidor em um componente React + TypeScript — escrevendo ou revisando um hook personalizado de busca de dados com respostas tipadas, estado de carregamento/erro, cancelamento de requisição e sem atualizações de estado após desmontagem, ou substituindo um useEffect + fetch ad-hoc. Aciona em "buscar dados no React", "useEffect fetch", "estado de carregamento", "custom hook", "chamada de API em um componente", "useFetch", "race condition em fetch", "cancelar requisição ao desmontar".

O que é react-data-hook?

Este skill define um playbook para buscar dados do servidor em React de forma correta: com tipagem, cancelamento e estados de carregamento e erro sempre gerenciados. Ele orienta o desenvolvedor a criar um hook personalizado `useFetch` que modela explicitamente três estados (loading, erro e sucesso) usando uma união discriminada, garantindo que estados inválidos sejam impossíveis de representar. O hook utiliza `AbortController` para cancelar requisições em andamento quando o componente desmonta ou as entradas mudam, prevenindo race conditions e bugs de UI desatualizada. Além disso, o skill recomenda o uso de bibliotecas consolidadas como TanStack Query (React Query) ou SWR quando presentes, e fornece uma lista de verificação para garantir que a implementação esteja completa e correta.

Funciona com~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 Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

React Data Hook

Um guia para buscar dados do servidor em React da maneira correta: tipado, cancelável e com estados de carregamento + erro sempre tratados.

Princípios

  • Um componente deve renderizar estado, não orquestrar requisições. Coloque a busca em um hook para que o componente permaneça declarativo.
  • Sempre modele três estados — loading, error, data. Nunca presuma que a requisição foi bem-sucedida.
  • Cancele requisições em andamento quando o componente desmontar ou as entradas mudarem. Uma resposta tardia que atualiza uma UI desmontada ou desatualizada é um bug real (flicker, dados errados, avisos do React), não teórico.
  • Tipifique a resposta. Um hook que retorna any apenas move o bug para downstream.

Primeiro: prefira uma biblioteca de dados real quando houver uma

Se o projeto já usa TanStack Query (React Query) ou SWR, use-a — não crie uma busca manual ao lado delas. Elas fornecem cache, deduplicação, retries e cancelamento gratuitamente:

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

Construa o hook abaixo apenas quando o projeto não tiver uma camada de dados e você não quiser adicionar uma.

O hook tipado base (zero dependências)

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

    return () => controller.abort(); // cancelar ao desmontar / mudança de url
  }, [url]); // reexecutar apenas quando a identidade da requisição mudar

  return state;
}

Por que está correto:

  • A união discriminada torna estados ilegais irrepresentáveis — você não pode ler data enquanto estiver loading.
  • AbortController + o cleanup retornado cancela a requisição anterior antes de iniciar uma nova, eliminando a race condition clássica onde respostas resolvem fora de ordem.
  • O ramo AbortError permanece silencioso, então um cancelamento normal nunca exibe um erro.

Usando-o — renderize todos os três estados

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

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

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

Renderizar um branch de loading e erro não é um polimento opcional — é a diferença entre uma tela em branco e uma utilizável.

Erros comuns que este skill previne

  • useEffect(() => { fetch(url).then(r => r.json()).then(setData) }, []) — sem estado de loading, sem tratamento de erro, sem cancelamento, e [] ignora uma url que muda.
  • Colocar valores não estáveis (um literal de objeto/array, um init inline) no array de dependências, causando um loop infinito de refetch. Memorize-os ou dependa de primitivos.
  • setData disparar após a desmontagem. O abort() no cleanup faz com que o .then tardio interrompa no AbortError.
  • Engolir respostas não-2xx — fetch só rejeita em falha de rede, então você deve verificar res.ok manualmente.

Lista de verificação antes de considerar concluído

  • A busca está em um hook; o componente apenas lê o estado.
  • Loading, erro e dados estão todos representados e todos renderizados.
  • A resposta é tipada (sem any); não-2xx é transformado em erro.
  • Um AbortController cancela na desmontagem e quando as entradas mudam.
  • O array de dependências contém apenas valores estáveis que definem a requisição.
  • Se o projeto tem React Query / SWR, este é usado no lugar deste hook.

Individual skills in this repo

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

Habilidades Relacionadas