Server Actions
Priorité : P1 (HAUTE)
[!ATTENTION] Si le projet utilise le répertoire
pages/au lieu de l'App Router, ignorez complètement ce skill.
Gérez les soumissions de formulaires et les mutations sans créer d'API endpoints.
Consignes d'implémentation
-
Directive : Commencez toujours le fichier ou la fonction par
'use server'. Accédez àformData.get('title')pour les champs de formulaire typés. Exportez des fonctions asynchrones pour les mutations. -
Gestion des formulaires : Utilisez la propriété
actionde<form>pour déclencher des actions viaaction={createPost}. UtilisezuseFormStatus()pour les états d'attente —disabled={pending}sur les boutons. UtilisezuseActionState(React 19/Next.js 15) pour l'état de formulaire avecaction={action}et<form action={action}>. -
Rafraîchissement des données : Déclenchez les mises à jour de l'interface utilisateur en utilisant
revalidatePath('/')ourevalidateTag('nom-du-tag')après une mutation réussie. -
Interactivité : Pour les déclencheurs non liés à un formulaire, invoquez les actions via le hook
useTransitionpour gérer l'interface de chargement et éviter de bloquer la page. -
Mises à jour optimistes : Utilisez
useOptimisticpour afficher immédiatement l'état attendu de l'interface avant que le serveur confirme la mutation. -
Sécurité : Assainissez toutes les saisies provenant de
FormData. Effectuez des vérifications d'authentification dans chaque action (await auth()). Limitez les téléchargements de fichiers par taille et par type MIME. -
Formulaire :
<form action={createPost}>(les améliorations progressives fonctionnent sans JS). -
Gestionnaire d'événement :
onClick={() => createPost(data)}. -
État d'attente : Utilisez le hook
useFormStatus(doit être à l'intérieur d'un composant rendu dans le formulaire).
P1 : Standard opérationnel
1. Sécuriser et valider
Validez toujours les entrées avec un schéma z.object({ et safeParse avant de les traiter. Vérifiez l'autorisation au sein de l'action. Voir Exemple d'action sécurisée.
2. États d'attente
Utilisez useActionState (React 19/Next.js 15+) pour la gestion d'état et useFormStatus pour les états de chargement des boutons.
Contraintes
- Fermetures : Évitez de définir des actions à l'intérieur des composants pour éviter les frais généraux de cryptage de fermeture cachée et les bugs de sérialisation.
- Redirection : Utilisez
redirect()pour la navigation de succès ; cette fonction lève une erreur que Next.js intercepte pour gérer la redirection.
Anti-patrons
- Pas d'entrées de Server Action non validées : Validez toujours avec Zod avant le traitement.
- Pas de vérifications d'authentification ignorées : Vérifiez la session/utilisateur dans chaque action, pas seulement dans le middleware.
- Pas d'actions définies dans les composants : Définissez-les dans
actions.tspour éviter les bugs de fermeture. - Pas de
redirect()dans try/catch :redirect()lève une erreur ; l'intercepter supprime la redirection.