Communityコーディング&開発github.com

Reactデータフック

React + TypeScriptコンポーネントでサーバーデータをフェッチする際に、型安全でキャンセル可能、ローディング/エラー状態を適切に管理するカスタムフックを作成・レビューするためのスキルです。

Reactデータフック とは?

このスキルは、Reactコンポーネントにおけるサーバーデータのフェッチを、型安全かつ堅牢に行うためのベストプラクティスを提供します。主な目的は、`useEffect`と`fetch`を直接コンポーネントに記述するアドホックなパターンを排除し、ローディング、エラー、データの3状態を明示的にモデル化したカスタムフックを構築することです。このフックは、`AbortController`を使用してコンポーネントのアンマウント時や入力変更時に処理中のリクエストを自動的にキャンセルし、競合状態やメモリリークを防止します。また、応答の型付けを必須とし、`any`型の使用を避けることでバグを未然に防ぎます。TanStack QueryやSWRのような既存のデータフェッチライブラリがプロジェクトで使用されている場合は、そちらを優先するよう推奨しています。このスキルはClaude Code、Cursor、Codexなど様々なAIエージェントで活用でき、ReactとTypeScriptを使用するあらゆるプロジェクトに適用可能です。

対応~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でサーバーデータを正しくフェッチするためのプレイブック:型安全、キャンセル可能、そしてローディングとエラー状態を常に処理します。

原則

  • コンポーネントは状態をレンダリングするべきであり、フェッチを調整すべきではありません。フェッチはフックに任せ、コンポーネントは宣言的に保ちます。
  • 常に3状態(loading、error、data)をモデル化します。リクエストが成功したと想定してはいけません。
  • コンポーネントがアンマウントされたとき、または入力が変更されたときに処理中のリクエストをキャンセルします。アンマウントされたUIや古い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;
}

なぜこれが正しいのか:

  • 判別可能なユニオン型により、不正な状態を表現できなくなります。loading中にdataを読み取ることはできません。
  • AbortControllerとクリーンアップの戻り値により、新しいリクエストを開始する前に前のリクエストをキャンセルし、応答が順不同で解決される古典的な競合状態を排除します。
  • AbortErrorブランチは沈黙を保つため、通常のキャンセルがエラーを表示することはありません。

使用方法 — 3状態すべてをレンダリングする

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.

関連スキル