Menu
CoddyTech

Qu’est-ce qu’une action serveur ?

Fait partie de la section L'essentiel de Next.js du Journey React de Coddy. Leçon 29 sur 47.

Tu peux maintenant lire des données sur le serveur. Il est temps de passer à l’autre moitié : les modifier.

Jusqu’à récemment, enregistrer une seule ligne de texte demandait étonnamment beaucoup de formalités. Tu écrivais un point de terminaison :

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

…puis l’a appelé depuis le navigateur :

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

Deux fichiers, une URL, une méthode, des en-têtes et du JSON dans les deux sens, pour transférer une chaîne d’un formulaire vers une base de données.

Une Server Action supprime tout. Écris une fonction asynchrone dans un fichier dont la première ligne est 'use server' :

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

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

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

…et transmettre cette fonction à un formulaire :

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

C’est tout. Trois détails méritent d’être mentionnés :

  • 'use server' doit être la première ligne du fichier : c’est le même type de marqueur que 'use client', mais dans l’autre sens. Il indique que tout ce qui est exporté ici s’exécute sur le serveur.
  • Le corps de la fonction n’atteint jamais le navigateur. Les identifiants de connexion à ta base de données y sont en sécurité : le navigateur ne reçoit qu’une référence qu’il peut appeler.
  • Tu n’as jamais écrit d’URL. Next.js crée le point de terminaison pour toi ; action={addItem} assure le raccordement.

Une différence avec les fondamentaux : ces champs de formulaire sont non contrôlés. Pas de useState, pas de value, pas de onChange : le navigateur conserve le texte, et l’attribut name permet à l’action de le trouver lors de l’envoi.

Essayez vous-même

Cette leçon ne comprend pas de défi de code.

quiz iconTestez-vous

Cette leçon comprend un petit quiz. Commencez la leçon pour y répondre et suivre votre progression.

Toutes les leçons de L'essentiel de Next.js