Menu
CoddyTech

Was ist eine Server Action?

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

Du kannst jetzt Daten auf dem Server lesen. Zeit für die andere Hälfte: sie zu ändern.

Bis vor Kurzem erforderte das Speichern einer einzigen Textzeile überraschend viel Aufwand. Du hast einen Endpunkt geschrieben:

// app/api/items/route.js
export async function POST(request) {
    const body = await request.json();
    saveItem(body.text);
    return Response.json({ ok: true });
}

…und rief es dann im Browser auf:

await fetch('/api/items', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text }),
});

Zwei Dateien, eine URL, eine Methode, Header und JSON in beide Richtungen, um eine Zeichenfolge von einem Formular in eine Datenbank zu übertragen.

Eine Server Action löscht alles davon. Schreibe eine asynchrone Funktion in eine Datei, deren erste Zeile 'use server' lautet:

// app/actions.js
'use server';

import { saveItem } from '../lib/db';

export async function addItem(formData) {
    saveItem(formData.get('text'));
}

…und übergib diese Funktion an ein Formular:

<form action={addItem}>
    <input name="text" />
    <button type="submit">Add</button>
</form>

Das ist schon alles. Drei Details sind wichtig:

  • 'use server' muss die erste Zeile der Datei sein: dieselbe Art von Markierung wie 'use client', nur in die andere Richtung. Sie bedeutet: Alles, was hier exportiert wird, wird auf dem Server ausgeführt.
  • Der Funktionskörper gelangt nie in den Browser. Deine Datenbank-Zugangsdaten sind darin sicher: Der Browser erhält nur eine Referenz, die er aufrufen kann.
  • Du hast nie eine URL geschrieben. Next.js erstellt den Endpunkt für dich; action={addItem} stellt die Verbindung her.

Ein Unterschied zu den Grundlagen: Diese Formulareingaben sind unkontrolliert. Kein useState, kein value, kein onChange: Der Browser behält den Text, und über das Attribut name findet die Aktion ihn beim Absenden.

Probier es selbst

Diese Lektion enthält keine Programmieraufgabe.

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