Menu
CoddyTech

Route-Handler

Teil des Abschnitts Next.js Essentials der React-Journey von Coddy. Lektion 37 von 47.

Serverkomponenten decken die meisten Datenanforderungen ab, da sie ohnehin bereits auf dem Server ausgeführt werden. Manchmal muss der Browser jedoch später Daten anfordern, etwa nach einem Klick oder nachdem sich ein Suchfeld beruhigt hat. Dafür brauchst du einen Endpunkt, den du aufrufen kannst.

Ein Ordner, der eine route.js enthält, wird genau zu dieser Route. Dieselbe Routing-Regel wie bei Seiten, aber eine andere spezielle Datei:

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

Darin exportierst du eine Funktion, die nach der HTTP-Methode benannt ist:

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

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

Response.json(...) ist die gesamte Antwort: Es serialisiert den Wert und legt den JSON-Inhaltstyp fest. Du kannst auch POST, PUT und DELETE aus derselben Datei exportieren.

Dann besteht die Client-Seite aus gewöhnlichem Browser-Code:

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

Zwei Dinge musst du auseinanderhalten. Ein Ordner kann eine page.jsx oder eine route.js enthalten, niemals beides: Beide würden dieselbe URL beanspruchen. Und route.js ist keine Komponente: Sie gibt eine Response zurück, kein JSX.

Greif auf einen Route-Handler zurück, wenn der Browser Daten bei Bedarf benötigt oder etwas außerhalb deiner App eine Anfrage senden muss. Wenn eine Server-Komponente die Daten einfach während des Renderns lesen kann, lass sie das tun.

challenge icon

Aufgabe

Mittel

Erstelle eine kleine API und rufe sie im Browser auf.

  1. Exportiere in app/api/dishes/route.js eine async function GET, die dishes als JSON zurückgibt.
  2. Vervollständige in components/DishLoader.jsx loadDishes: Rufe /api/dishes ab, lies den JSON-Body und speichere die Gerichtsnamen mit setNames.

Beim Klicken auf #load-btn müssen alle vier Namen in #dish-list angezeigt werden.

Probier es selbst

import './globals.css';

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

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz iconTeste dich selbst

Diese Lektion enthält ein kurzes Quiz. Starte die Lektion, um es zu beantworten und deinen Fortschritt zu speichern.

Alle Lektionen in Next.js Essentials