Server Actions sunt funcții asincrone care rulează pe server, dar pot fi apelate direct din componentele tale (inclusiv din formularele și handlerii de evenimente) — permițând ți să efectuezi mutații (create/update/delete) fără a construi manual un endpoint API. Le marchezi cu directiva "use server".
;
{ revalidatePath } ;
() {
title = formData.() ;
db..({ : { title } });
();
}
// 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>
);
}
action-ul formularului indică Server Action-ul. La trimitere, Next.js trimite FormData la server, rulează funcția acolo și poate revalida paginile afectate — tot fără rută API și fără cod de fetch pe partea clientului.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts și fetches pe client.revalidatePath/revalidateTag reîmprospătează datele în cache după mutație.⚠️ Server Actions are PUBLIC endpoints under the hood — always validate input and
check authorization inside them, exactly as you would a real API route.
Server Actions comprima stackul de mutație obișnuit (rută API + fetch pe client + gestionare stare) într-o singură funcție de server pe care o apelezi direct — răspunsul App Router-ului la formularele și schimbările de date.
Reduc boilerplate, permit îmbunătățirea progresivă și se integrează cu caching/revalidare, dar (ca orice endpoint) necesită validare și verificări de autentificare în interiorul lor.