Menu
CoddyTech

ルートハンドラー

CoddyのReactジャーニー「Next.js の基本」セクションの一部。レッスン 37/47。

サーバーコンポーネントは、すでにサーバー上で実行されるため、ほとんどのデータ取得のニーズに対応できます。しかし、クリック後や検索ボックスの入力が落ち着いた後など、ブラウザーがデータを後から要求しなければならないこともあります。その場合は、呼び出すエンドポイントが必要です。

route.jsが入っているフォルダーは、そのままの名前になります。ページと同じルーティング規則ですが、特別なファイルが異なります。

app/
    api/
        dishes/
            route.js     ->  /api/dishes

内部では、HTTPメソッドにちなんだ名前の関数をエクスポートします。

import { dishes } from '../../../lib/dishes.js';

export async function GET() {
    return Response.json(dishes);
}

Response.json(...)は返信全体を表し、値をシリアライズしてJSONのコンテンツタイプを設定します。同じファイルからPOST、PUT、DELETEもエクスポートできます。

次に、クライアント側は通常のブラウザーコードです。

const res = await fetch('/api/dishes');
const data = await res.json();

覚えておくべきことが2つあります。フォルダーには page.jsx または route.js のどちらか一方だけを置けます。両方を置くことはできません。どちらも同じURLを担当することになるためです。また、route.js はコンポーネントではありません。JSXではなく、Response を返します。

ブラウザーが必要に応じてデータを必要とするときや、アプリの外部から呼び出す必要があるときは、ルートハンドラーを使いましょう。サーバーコンポーネントがレンダリング中にデータを読み取るだけで済むなら、そうさせましょう。

challenge icon

チャレンジ

中級

小さなAPIを作成し、ブラウザーから呼び出しましょう。

  1. app/api/dishes/route.jsで、dishesをJSONとして返すasync function GETをエクスポートします。
  2. components/DishLoader.jsxで、loadDishesを完成させます。/api/dishesを取得し、JSON本文を読み込み、料理の名前をsetNamesで保存します。

#load-btnをクリックすると、#dish-listに4つすべての名前が表示される必要があります。

自分で試してみよう

import './globals.css';

export const metadata = {
    title: 'My App',
};

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz icon腕試し

このレッスンには短いクイズがあります。レッスンを始めて解答し、進捗を記録しましょう。

Next.js の基本のすべてのレッスン