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がある場合は、このフックの代わりにそれが使用されています。