Community코딩 & 개발github.com

React 데이터 훅

React + TypeScript 컴포넌트에서 서버 데이터를 가져올 때 사용합니다. 타입 응답, 로딩/에러 상태, 요청 취소, 언마운트 후 상태 업데이트 방지 기능을 갖춘 커스텀 훅을 작성하거나 검토할 때, 또는 임시방편 `useEffect` + `fetch`를 대체할 때 활용하세요.

React 데이터 훅란 무엇인가요?

React 데이터 훅은 React 컴포넌트에서 서버 데이터를 가져올 때 올바른 패턴을 제공하는 스킬입니다. 이 스킬은 **타입 안전성, 요청 취소 가능, 로딩 및 에러 상태 처리를 항상 포함한** 커스텀 훅 작성 방법을 명확히 제시합니다. 주요 플랫폼으로는 Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 동작합니다. 이 스킬은 TanStack Query(React Query)나 SWR 같은 실제 데이터 라이브러리가 프로젝트에 있을 경우 이를 우선 사용하고, 그렇지 않을 경우에만 제로 의존성으로 직접 훅을 구축하는 전략을 안내합니다. 특히 `AbortController`를 이용한 언마운트 시 요청 취소, 상태 표현을 위한 식별된 유니온 타입, 모든 HTTP 상태 코드에 대한 명시적 에러 처리를 강조하여, 일반적인 React 데이터 페칭 버그(예: 화면 깜빡임, 잘못된 데이터 표시, React 경고)를 방지합니다.

지원 대상~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 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

React 데이터 훅은(는) 무엇을 하나요?

React에서 서버 데이터를 올바르게 가져오기 위한 플레이북입니다: 타입 안전하고, 취소 가능하며, 항상 로딩 + 에러 상태를 처리합니다.

원칙

  • 컴포넌트는 상태를 렌더링해야 하며, 가져오기를 조정해서는 안 됩니다. 가져오기는 훅에 넣어 컴포넌트가 선언형을 유지하세요.
  • 항상 세 가지 상태 — 로딩, 에러, 데이터 — 를 모델링하세요. 요청이 성공했다고 가정하지 마세요.
  • 컴포넌트가 언마운트되거나 입력이 변경될 때 진행 중인 요청을 취소하세요. 늦은 응답이 언마운트되거나 오래된 UI를 업데이트하면 실제 버그(깜빡임, 잘못된 데이터, React 경고)가 발생합니다. 이론적인 문제가 아닙니다.
  • 응답에 타입을 지정하세요. any를 반환하는 훅은 버그를 다운스트림으로 옮길 뿐입니다.

먼저: 실제 데이터 라이브러리가 있으면 우선 사용하세요

프로젝트가 이미 TanStack Query(React Query) 또는 SWR을 사용하고 있다면, 이를 사용하세요. 수작업으로 가져오기를 구현하지 마세요. 캐싱, 중복 제거, 재시도, 취소를 무료로 제공합니다:

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

아래 훅은 프로젝트에 데이터 계층이 없고 추가하고 싶지 않을 때만 빌드하세요.

기본 타입 훅 (의존성 없음)

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

    return () => controller.abort(); // 언마운트 / url 변경 시 취소
  }, [url]); // 요청 식별자가 변경될 때만 재실행

  return state;
}

올바른 이유:

  • 식별된 유니온은 불법 상태를 표현 불가능하게 만듭니다. — 로딩 중에는 data를 읽을 수 없습니다.
  • AbortController + 정리 함수 반환은 새 요청을 시작하기 전 이전 요청을 취소하여, 응답이 순서에 맞지 않게 해결되는 고전적인 경쟁 상태를 제거합니다.
  • AbortError 분기는 조용히 처리되므로, 정상적인 취소가 에러를 표시하지 않습니다.

사용하기 — 세 가지 상태 모두 렌더링

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

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

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

로딩 및 에러 분기를 렌더링하는 것은 선택적인 장식이 아닙니다. 빈 화면과 사용 가능한 화면의 차이를 만듭니다.

이 스킬이 방지하는 일반적인 실수

  • useEffect(() => { fetch(url).then(r => r.json()).then(setData) }, []) — 로딩 상태 없음, 에러 처리 없음, 취소 없음, []는 변경되는 url을 무시합니다.
  • 의존성 배열에 안정적이지 않은 값(객체/배열 리터럴, 인라인 init)을 넣어 무한 리페치 루프 발생. 값들을 메모이제이션하거나 원시 값에 의존하세요.
  • 언마운트 후 setData가 실행됨. 정리 함수 abort()는 늦은 .then이 AbortError에서 조기 종료되도록 만듭니다.
  • 2xx가 아닌 응답 무시 — fetch는 네트워크 실패 시에만 거부하므로, 직접 res.ok를 확인해야 합니다.

완료 전 체크리스트

  • 가져오기는 훅에 있으며; 컴포넌트는 상태만 읽습니다.
  • 로딩, 에러, 데이터가 모두 표현되고 모두 렌더링됩니다.
  • 응답에 타입이 지정되었습니다(any 없음); 2xx가 아닌 응답은 에러로 변환됩니다.
  • AbortController가 언마운트 및 입력 변경 시 취소합니다.
  • 의존성 배열에는 요청을 정의하는 안정적인 값만 포함됩니다.
  • 프로젝트에 React Query / SWR이 있다면 이 훅 대신 사용됩니다.

Individual skills in this repo

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

관련 스킬