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 が動き続けているかを確認し、必要に応じて再起動してから、ページをリロードしてください。