Next.jsで学ぶReact講座 90日コース | Next.js基礎 - Day 42:データ取得

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 42:データ取得を理解して、外部APIからデータを表示する

Day 42では、Next.js App Routerでのデータ取得を学びます。今日は特に、Server Side Fetch、async Component、外部APIからのデータ取得をつなげて理解し、「ページを開いたときにサーバー側でデータを取得して表示する」流れを実践します。App Routerでは、ページやレイアウトは既定でServer Componentsなので、async関数にしてfetchを直接書けます。さらに、Next.jsのfetchはキャッシュや再検証の設定を持つ拡張版です。 (🔗 nextjs.org)

今日は「とにかく動かす」だけでなく、なぜuseEffectではなくページ自体をasyncにするのか、なぜServer Componentで取得するのか、いつcache: 'no-store'やrevalidateを使うのかまで、初心者向けに順序立てて理解していきます。 (🔗 nextjs.org)

1. まず結論を先に理解する

App Routerでは、外部APIからのデータ取得は、まずServer Componentでasync/awaitを使って取得する形から学ぶのが基本です。公式ドキュメントでも、Server Componentを非同期関数にして、その中でawait fetch(...)する例が案内されています。 (🔗 nextjs.org)

この考え方を短く言うと、次のようになります。

  • ページが表示される前に必要なデータは、Server Componentで取得します。
  • ページ自体を`async`にして、`await fetch(…)`します。
  • 取得したデータをそのままJSXで表示します。
  • 入力やクリック操作が必要な部品だけ、後からClient Componentに分けます。

この流れにしておくと、初回表示に必要なデータ取得をサーバー側に寄せやすく、Client Componentへ不要な処理や秘密情報を持ち込まずに済みます。 (🔗 nextjs.org)

2. Server Side Fetchとは

ここでいうServer Side Fetchとは、Server Componentの中でサーバー側からfetchを実行することです。Next.js公式では、Server Componentsの中でfetchを使ってデータ取得でき、async/awaitを直接書けると説明されています。 (🔗 nextjs.org)

Reactだけを学んできた段階では、「データ取得はuseEffectでやるもの」と思いやすいですが、Next.js App Routerでは考え方が少し変わります。ページやレイアウトがServer Componentsなので、最初からサーバーでデータを取って描画できるからです。 (🔗 nextjs.org)

3. async Componentとは

async Componentとは、async functionとして書かれたServer Componentのことです。たとえば、次のようなページです。

// ページ自体を非同期関数にしています
export default async function Page() {
  // サーバー側でデータを取得します
  const response = await fetch("https://api.vercel.app/blog");

  // JSONをJavaScriptの値に変換します
  const posts = await response.json();

  return <div>...</div>;
}
TSX

Next.jsでは、このようにServer Componentをasyncにし、await fetch()を直接書くのが基本形として案内されています。 (🔗 nextjs.org)

つまり、Day 42で大切なのは、「データ取得専用の特別な関数を書く」のではなく、「ページそのものを非同期にする」という発想です。Pages Router時代のgetServerSidePropsとは考え方が違います。App Routerでは、取得処理をページやコンポーネントの近くに置けます。 (🔗 nextjs.org)

4. 今日作る実践アプリの完成イメージ

今日は、外部APIからブログ記事の一覧を取得して表示するページを作ります。例として、Next.js公式の例でも使われているブログAPI形式のエンドポイントを使います。取得したデータを/postsページで一覧表示し、読み込み中の表示も加えます。 (🔗 nextjs.org)

作るファイル構成は次のようにします。

src/
├── app/
│   ├── posts/
│   │   ├── loading.tsx
│   │   └── page.tsx
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx
└── lib/
    └── posts.ts

この構成にすると、/postsへアクセスしたときにサーバー側でデータ取得し、読み込み中はloading.tsxを表示できます。loading.tsxは同じフォルダーに置くと、そのルートセグメントの読み込みUIとして自動的に使われます。 (🔗 nextjs.org)

5. Step 1:トップページから移動できるようにする

最初に、ホームから記事一覧ページへ移動できるようにします。

src/app/page.tsx

// Next.jsのリンク機能を読み込みます
import Link from "next/link";

// ホームページです
export default function HomePage() {
  return (
    <main>
      <h1>Day 42:データ取得</h1>
      <p>
        Next.jsのServer Componentで外部APIからデータを取得する練習です。
      </p>

      <p>
        {/* 記事一覧ページへ移動します */}
        <Link href="/posts">記事一覧を見る</Link>
      </p>
    </main>
  );
}
TSX

ここではまだデータ取得はしていません。先に移動先を作る準備です。

6. Step 2:取得するデータの型と関数を分ける

次に、外部APIを呼び出す処理をlibへ分けます。ページに直接すべて書くこともできますが、学習初期から「表示」と「データ取得」を分ける癖をつけると、後で保守しやすくなります。

src/lib/posts.ts

// 記事1件分の型です
export type Post = {
  id: string;
  title: string;
};

// 外部APIから記事一覧を取得する関数です
export async function getPosts(): Promise<Post[]> {
  // サーバー側で外部APIへアクセスします
  const response = await fetch("https://api.vercel.app/blog", {
    // 常に最新データを取得したいときの例です
    cache: "no-store",
  });

  // 通信に失敗した場合はエラーにします
  if (!response.ok) {
    throw new Error("記事データの取得に失敗しました。");
  }

  // JSONを配列として返します
  return response.json();
}
TSX

このコードで特に重要なのは、fetchにcache: "no-store"を付けている点です。Next.jsのfetchはキャッシュ設定を持っており、no-storeを指定すると、リクエストごとにリモートサーバーから取得します。 (🔗 nextjs.org)

初心者のうちは、「APIから毎回最新情報を取りたいならcache: "no-store"」と覚えると分かりやすいです。ただし、ニュースや在庫のように常に最新である必要がない場合は、あとでrevalidateを使う選択もあります。これは後で説明します。 (🔗 nextjs.org)

7. Step 3:asyncなページでデータを取得して表示する

次に、/postsページを作ります。ページ自体をasyncにして、先ほどのgetPosts()を待ってから表示します。

src/app/posts/page.tsx

// データ取得関数を読み込みます
import { getPosts } from "../../lib/posts";

// 記事一覧ページです
export default async function PostsPage() {
  // サーバー側で記事一覧を取得します
  const posts = await getPosts();

  return (
    <main>
      <h1>記事一覧</h1>
      <p>外部APIから取得したデータを表示しています。</p>

      <ul>
        {posts.map((post) => (
          // APIから受け取ったidをkeyに使います
          <li key={post.id}>
            {post.title}
          </li>
        ))}
      </ul>
    </main>
  );
}
TSX

これが、Day 42でまず覚えたい最小の完成形です。ページをasyncにし、await getPosts()し、その結果をそのままJSXへ流し込んでいます。App Routerでは、この書き方がとても自然です。 (🔗 nextjs.org)

ここで大切なのは、useEffectもuseStateも使っていないことです。なぜなら、これはClient Componentではなく、Server Componentでのデータ取得だからです。表示前にサーバーでデータを集めて、その結果をHTMLに反映できます。 (🔗 nextjs.org)

8. Step 4:読み込み中の画面を追加する

次に、読み込み中の表示を加えます。Next.jsでは、同じフォルダーにloading.tsxを置くと、そのページの読み込み中UIとして使えます。

src/app/posts/loading.tsx

// 読み込み中に表示するUIです
export default function Loading() {
  return (
    <main>
      <h1>記事一覧</h1>
      <p>記事データを読み込んでいます...</p>
    </main>
  );
}
TSX

loading.tsxは、ナビゲーション時にすぐ表示されるローディングUIです。公式ドキュメントでも、同じフォルダーにloading.jsまたはloading.tsxを置くと、そのルートセグメントに対して自動的に読み込み表示が使われると説明されています。 (🔗 nextjs.org)

初心者のうちは、「重い処理だからローディングを付ける」のではなく、「データ取得があるなら、まずローディング状態も考える」という習慣を持つと実践的です。特に外部APIは自分のコードより遅くなる可能性があるため、利用者に「ちゃんと動いている」と伝える表示が大切です。 (🔗 nextjs.org)

9. Step 5:fetchをページに直接書く場合も理解する

さきほどはlib/posts.tsへ分けましたが、学習の最初はページへ直接書いても構いません。公式の基本例も、ページの中で直接fetchしています。 (🔗 nextjs.org)

// 記事一覧ページです
export default async function PostsPage() {
  // ページの中で直接fetchする例です
  const response = await fetch("https://api.vercel.app/blog", {
    cache: "no-store",
  });

  // 通信結果が失敗ならエラーにします
  if (!response.ok) {
    throw new Error("記事データの取得に失敗しました。");
  }

  // JSONを配列に変換します
  const posts: { id: string; title: string }[] = await response.json();

  return (
    <main>
      <h1>記事一覧</h1>

      <ul>
        {posts.map((post) => (
          <li key={post.id}>{post.title}</li>
        ))}
      </ul>
    </main>
  );
}
TSX

この形でも正しいです。ただし、同じ取得処理を別ページでも使いたい場合は、libへ分けるほうが整理しやすくなります。

10. Step 6:cache: "no-store"とrevalidateの違いを理解する

Next.jsのfetchは、サーバー側でのキャッシュや再検証を設定できます。代表的なのがcache: "no-store"とnext: { revalidate: number }です。 (🔗 nextjs.org)

常に最新を取得したい場合

// 毎回APIへアクセスして最新データを取りにいく例です
await fetch("https://api.vercel.app/blog", {
  cache: "no-store",
});
TypeScript

no-storeは、毎回リモートサーバーから取得する指定です。最新性を優先したいときに向いています。 (🔗 nextjs.org)

一定時間キャッシュしたい場合

// 60秒ごとに再検証する例です
await fetch("https://api.vercel.app/blog", {
  next: { revalidate: 60 },
});
TypeScript

revalidate: 60は、最大60秒のキャッシュ寿命を持たせる設定です。たとえば「1分以内なら多少古くてもよいが、ずっと古いのは困る」データに向いています。 (🔗 nextjs.org)

ここで重要な注意があります。cache: "no-store"とnext: { revalidate: 60 }のように、矛盾する設定を同時に書くのは避けてください。公式ドキュメントでは、こうした競合オプションは許可されず、無視され、開発中は警告が出ると説明されています。 (🔗 nextjs.org)

11. Step 7:なぜuseEffectではなくServer Componentで取るのか

初心者が最も疑問に思いやすいのがここです。React単体ではuseEffectでデータ取得する場面が多いですが、Next.js App Routerでは、最初の表示に必要なデータはServer Componentで取得するのが基本です。 (🔗 nextjs.org)

理由は次の通りです。

  • ページやレイアウトは既定でServer Componentsだからです。
  • Server Componentでは`async/await`を直接使えるからです。
  • サーバーで取得すれば、秘密情報や取得ロジックをクライアントへ送らずに済むからです。
  • 初回表示に必要なデータを先に集めて描画しやすいからです。

公式ドキュメントでも、Server ComponentsはAPIやデータベースの近くでデータ取得しやすく、秘密情報をクライアントへ露出せず、ブラウザーへ送るJavaScript量を減らせると説明されています。 (🔗 nextjs.org)

12. Step 8:Client Componentでデータ取得する場面も知っておく

Day 42の主役はServer Side Fetchですが、Client Componentでもデータ取得する場面はあります。公式ドキュメントでは、Client Componentsでの取得方法として、Reactのuse APIやコミュニティライブラリが紹介されています。 (🔗 nextjs.org)

ただし、今日の段階では、次のように整理すると混乱しにくいです。

  • 最初の表示に必要なデータ:まずServer Componentで取得します。
  • クリック後に変わる内容やブラウザー操作に強く結びつく内容:必要に応じてClient側取得を検討します。

つまり、Day 42では「まずサーバーで取る」を土台にしてください。

13. Step 9:エラー処理を深掘りする

fetch()は、通信先が落ちていたり、想定外のレスポンスを返したりすることがあります。初心者ほど「動くときだけを考える」状態になりやすいですが、実践では失敗時の扱いも大切です。

response.okを確認する書き方は、次のように覚えるとよいです。

// 通信結果を受け取ります
const response = await fetch("https://api.vercel.app/blog", {
  cache: "no-store",
});

// HTTPステータスが失敗ならエラーにします
if (!response.ok) {
  throw new Error("記事データの取得に失敗しました。");
}
TypeScript

このようにしておくと、「APIは呼べたが、200番台ではなかった」ケースも検出できます。Next.js公式のBackend for Frontendガイドでも、例外が起こり得る処理にはtry/catchを使い、クライアントへ送るエラーメッセージに敏感な情報を含めないよう注意が示されています。 (🔗 nextjs.org)

14. Step 10:秘密情報を扱うときの考え方

外部APIの中には、APIキーやトークンが必要なものがあります。その場合、キーをClient Componentへ書かないことがとても重要です。Server Componentsは、APIキーやトークンのような秘密情報をクライアントへ露出せずに使える場所として案内されています。 (🔗 nextjs.org)

考え方は次の通りです。

  • 秘密情報を使う取得処理はServer Component側に置きます。
  • Client Componentには、表示に必要な結果だけを渡します。
  • Client側にキーを埋め込まないようにします。

これは性能だけでなく、セキュリティの基本でもあります。

15. Step 11:Route Handlerを経由すべきかを理解する

初心者は「外部APIを取るなら、いったん自分の/apiを経由したほうがよいのでは」と考えがちですが、Server Componentで使うデータ取得は、まず取得元へ直接アクセスするのが基本です。Next.js公式のBackend for Frontendガイドでも、Server ComponentsではRoute Handlers経由ではなく、データソースから直接取得するよう案内されています。ビルド時にはその内部HTTP呼び出し先のサーバーが存在せず失敗し得ることや、実行時でも余計なHTTP往復が増えるためです。 (🔗 nextjs.org)

つまり、今日のようなServer Side Fetchでは、次の考え方が自然です。

  • Server Componentなら、外部APIへ直接`fetch`します。
  • Route Handlerは、公開APIエンドポイントが必要なときや、外部向けのAPI層が必要なときに使います。

この違いは初学者にとってかなり大切です。

16. Step 12:初心者向けテンプレート

今後も再利用しやすいように、最小テンプレートを載せておきます。

データ取得関数テンプレート

// 取得するデータの型です
export type Item = {
  id: string;
  title: string;
};

// 外部APIから一覧を取得します
export async function getItems(): Promise<Item[]> {
  // サーバー側で通信します
  const response = await fetch("https://api.vercel.app/blog", {
    // 毎回最新を取得したい例です
    cache: "no-store",
  });

  // 失敗時はエラーを投げます
  if (!response.ok) {
    throw new Error("データ取得に失敗しました。");
  }

  // JSONを返します
  return response.json();
}
TypeScript

asyncページテンプレート

// データ取得関数を読み込みます
import { getItems } from "../../lib/items";

// 一覧ページです
export default async function Page() {
  // サーバー側でデータを取得します
  const items = await getItems();

  return (
    <main>
      <h1>一覧ページ</h1>

      <ul>
        {items.map((item) => (
          // 一意なidをkeyに使います
          <li key={item.id}>{item.title}</li>
        ))}
      </ul>
    </main>
  );
}
TSX

loading.tsxテンプレート

// 読み込み中に表示するUIです
export default function Loading() {
  return <p>読み込み中です...</p>;
}
TSX

この3点セットを理解しておくと、ニュース一覧、商品一覧、投稿一覧、ユーザー一覧など、さまざまなページに応用できます。

17. よくあるつまずき

  • ページを`async`にしていない:`await fetch()`を書くなら、ページや取得関数が非同期である必要があります。
  • Server Componentなのに`useEffect`を書こうとする:Day 42ではまずServer側取得を使います。Client側取得は別の用途です。
  • `response.ok`を確認していない:通信失敗やAPIエラーを見逃しやすくなります。
  • `no-store`と`revalidate`を同時に書く:競合設定になるため避けます。
  • 秘密情報をClient側に置く:APIキーやトークンをブラウザーへ送らないようにします。
  • Server Componentなのに自分のRoute Handlerを無駄に経由する:まずデータソースへ直接取りにいく構成を考えます。

18. Day 42のチェックリスト

  • Server Componentで`fetch`を直接使えると説明できます。
  • ページ自体を`async`にしてデータ取得できると説明できます。
  • 外部APIから取得したJSONを一覧表示できます。
  • `loading.tsx`で読み込み中UIを作れます。
  • `cache: “no-store”`と`revalidate`の役割の違いを説明できます。
  • 秘密情報をServer側にとどめるべき理由を説明できます。
  • Server ComponentではRoute Handler経由より、取得元から直接取るのが基本だと説明できます。

まとめ

Day 42では、Next.js App Routerでのデータ取得の基本として、Server Side Fetch、async Component、外部APIからの取得を学びました。App Routerではページやレイアウトが既定でServer Componentsなので、ページをasyncにし、その中でawait fetch()を書くのが自然な書き方です。Next.jsのfetchはサーバー側キャッシュや再検証の設定も持っており、用途に応じてno-storeやrevalidateを選べます。 (🔗 nextjs.org)

実践では、lib/posts.tsに取得処理を分け、app/posts/page.tsxで一覧表示し、loading.tsxで読み込み中UIも追加しました。ここまでできれば、次は詳細ページでIDごとに外部APIを取得する、loading.tsxとSuspenseを使い分ける、エラー画面を追加するといった、より実践的なNext.jsデータ取得へつなげられます。 (🔗 nextjs.org)

タイトルとURLをコピーしました