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.
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
1Pourquoi Next.js
Ce que Next.js apporteLe dossier appVotre première pageRécapitulatif : pourquoi Next.js2Routage et liens
Les dossiers sont des routesRoutes imbriquéesLier les pagesRoutes dynamiquesPages introuvablesRécapitulatif : routage3Mises en page et métadonnées
La mise en page racineNavigation partagéeMises en page imbriquéesMétadonnées de pageMétadonnées dynamiquesRécapitulatif : mises en page6Actions serveur
Qu’est-ce qu’une action serveur ?Des formulaires qui agissentLire les données d’un formulaireActualiser la pageRécapitulatif : actions serveur