Server Actions sont des fonctions asynchrones qui s'exécutent sur le serveur mais peuvent être appelées directement depuis vos composants (y compris depuis des formulaires et des gestionnaires d'événements) — vous permettant d'effectuer des mutations (créer/mettre à jour/supprimer) sans construire manuellement une route API. Vous les marquez avec la directive "use server".
// app/todos/actions.ts
"use server";
import { revalidatePath } from "next/cache";
export async function createTodo(formData: FormData) {
const title = formData.get("title") as string;
await db.todo.create({ data: { title } }); // runs on the server — DB access, secrets
revalidatePath("/todos"); // refresh the cached page with new data
}
// app/todos/page.tsx — wire the action straight to a form
import { createTodo } from "./actions";
export default function Page() {
return (
<form action={createTodo}> {/* no onSubmit, no fetch, no /api route */}
<input name="title" />
<button>Add</button>
</form>
);
}
L'attribut action du formulaire pointe vers la Server Action. À la soumission, Next.js envoie le FormData au serveur, exécute la fonction sur place, et peut revalider les pages affectées — tout cela sans route API et sans code fetch côté client.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts et des fetches clients.revalidatePath/revalidateTag rafraîchissent les données en cache après la mutation.⚠️ Server Actions are PUBLIC endpoints under the hood — always validate input and
check authorization inside them, exactly as you would a real API route.
Les Server Actions réduisent la pile de mutation habituelle (route API + fetch client + gestion d'état) en une seule fonction serveur que vous appelez directement — la réponse de l'App Router aux formulaires et aux changements de données.
Ils réduisent le boilerplate, permettent l'amélioration progressive, et s'intègrent avec la mise en cache/revalidation, mais (comme n'importe quel point de terminaison) nécessitent une validation et des vérifications d'authentification à l'intérieur.