fetch API でのデータ取得
APIが動くことを確認できたので、次はブラウザ側から fetch でAPIを呼び出してタスク一覧を表示します。ここではまず、React標準の useEffect + useState の組み合わせで、ロード中・エラー・成功の3状態を自分で管理する書き方を体験します。
1. Client Component での一覧表示
Route Handlersを呼び出すコンポーネントを、app/tasks/page.tsx として作成します。Visual Studio Codeのエクスプローラーで app フォルダを右クリックし、「新しいフォルダー」から tasks を作成し、その中に page.tsx を新規作成します。
frontend-fetch-demo
├── app/
│ ├── api/
│ │ └── tasks/
│ │ └── route.ts
│ ├── tasks/ ← このフォルダを作成
│ │ └── page.tsx ← このファイルを作成
│ ├── layout.tsx
│ └── page.tsx
└── ...
Client Componentから fetch を呼ぶときは、ファイル冒頭に "use client" を書き、useEffect の中で fetch を実行するのが基本の書き方になります。書き方は以下のとおりです。
"use client";
import { useEffect, useState } from "react";
export default function コンポーネント名() {
const [データ, setデータ] = useState<型>(初期値);
useEffect(() => {
const load = async () => {
const res = await fetch("エンドポイントURL");
const data = await res.json();
setデータ(data);
};
load();
}, []);
return (
// 画面表示
);
}
以下は、/api/tasks から一覧を取得して表示する実装例です。ロード中・エラーの状態管理とリクエスト中断まで含めた形にしています。作成した page.tsx に以下の内容を記述して保存します。
"use client";
import { useEffect, useState } from "react";
type Task = {
id: number;
title: string;
done: boolean;
};
export default function TasksPage() {
const [tasks, setTasks] = useState<Task[]>([]);
const [isLoading, setIsLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
const controller = new AbortController();
const load = async () => {
try {
setIsLoading(true);
setError(null);
const res = await fetch("/api/tasks", { signal: controller.signal });
if (!res.ok) {
throw new Error(`HTTP ${res.status}`);
}
const data: Task[] = await res.json();
setTasks(data);
} catch (err) {
if (err instanceof DOMException && err.name === "AbortError") {
return;
}
setError(err instanceof Error ? err.message : "unknown error");
} finally {
setIsLoading(false);
}
};
load();
return () => controller.abort();
}, []);
if (isLoading) return <p>読み込み中...</p>;
if (error) return <p>エラー: {error}</p>;
return (
<main style={{ padding: 24 }}>
<h1>タスク一覧</h1>
<ul>
{tasks.map((task) => (
<li key={task.id}>
{task.title} {task.done ? "(完了)" : ""}
</li>
))}
</ul>
</main>
);
}
コードを解説します。
"use client";
冒頭の "use client" ディレクティブは、このファイルをClient Componentとして扱うようNext.jsに伝えます。useState / useEffect はブラウザ側のフックのため、Server Componentのままでは使えません。
const [tasks, setTasks] = useState<Task[]>([]);
const [isLoading, setIsLoading] = useState(true);
const [error, setError] = useState<string | null>(null);
タスク本体・ロード中フラグ・エラーメッセージの3つを、それぞれ独立した状態として持ちます。シンプルな fetch を使うときは、この3つを自分で組み合わせて画面表示を切り替えるのが基本です。
useEffect(() => {
const controller = new AbortController();
const load = async () => {
try {
setIsLoading(true);
setError(null);
const res = await fetch("/api/tasks", { signal: controller.signal });
if (!res.ok) {
throw new Error(`HTTP ${res.status}`);
}
const data: Task[] = await res.json();
setTasks(data);
} catch (err) {
if (err instanceof DOMException && err.name === "AbortError") {
return;
}
setError(err instanceof Error ? err.message : "unknown error");
} finally {
setIsLoading(false);
}
};
load();
return () => controller.abort();
}, []);
useEffect の中で fetch を呼び、レスポンスを await res.json() でオブジェクトに変換して tasks に入れています。fetch の戻り値はPromiseで、.json() もPromiseを返すため、async / await で順に待ちます。
AbortController は、コンポーネントが画面から消えた(unmountされた)ときに進行中のリクエストを中断するためのオブジェクトです。useEffect のクリーンアップ関数で controller.abort() を呼ぶことで、ページを離れた瞬間にリクエストを止められます。中断された場合は AbortError として catch に入るため、エラー表示を出さずに早期returnで無視しています。
fetch はHTTPステータスが4xx/5xxでもPromiseがrejectされない仕様のため、if (!res.ok) の分岐で自分で例外を投げる必要があります。この点は誤りやすいので、覚えておくと役立ちます。
| 📝 fetchのエラーハンドリング |
|---|
fetch は「ネットワーク自体が失敗した場合」だけPromiseをrejectします。HTTPステータスコードが 404 や 500 の場合でもrejectはされず、res.ok が false になるだけです。詳しくは Using the Fetch API - Checking response status(MDN) に「The promise returned by fetch() will reject on some errors, such as a network error or a bad scheme. However, if the server responds with an error like 404, then fetch() fulfills with a Response, so we have to check the status before we can read the response body.」と記載があります。 |
if (isLoading) return <p>読み込み中...</p>;
if (error) return <p>エラー: {error}</p>;
状態に応じて表示するJSXを切り替えます。読み込み中・エラー・成功の3パターンを、それぞれ別のJSXで返す形にしておくと分岐が読みやすくなります。
2. ブラウザでの一覧確認
コードを保存したら、ブラウザで http://localhost:3000/tasks を開きます。以下のように、一瞬「読み込み中...」と表示された後、Route Handlersで用意した2件のタスクが一覧表示されます。
「タスク一覧」の見出しと、初期データの Next.jsのRoute Handlersを試す / fetch APIでデータを取得する の2件が並んで表示されていれば、Client Componentからの fetch によるデータ取得は成功です。
⚠️ Failed to fetch と表示される場合 |
|---|
開発サーバ(npm run dev)が停止していると、fetch がネットワークエラーになります。まずターミナルで npm run dev が動き続けているかを確認し、必要に応じて再起動してから、ページをリロードしてください。 |