Server Actions janë funksione asinkrone që ekzekutohen në server por mund të thirren drejtpërdrejt nga komponentët tuaj (duke përfshirë formularët dhe menaxherët e eventeve) — duke ju lejuar të kryeni mutacione (krijo/përditeso/fshi) pa ndërtuar manualisht një endpoint të API-t. Ju i shënoni ato me direktivën "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>
);
}
action i formularit tregon në Server Action. Në dorëzim, Next.js dërgon FormData në server, ekzekuton funksionin atje, dhe mund të rivalidon faqet e prekura — të gjitha pa asnjë rugë API dhe pa kod fetch në anën e klientit.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts dhe fetch të klientit.revalidatePath/revalidateTag rifreskojnë të dhënat e memorizuara pas mutacionit.⚠️ 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 e shembullin stakun e zakonshëm të mutacionit (rrugë API + klient fetch + menaxhim i gjendjës) në një funksion të vetëm në server që ju thrrni drejtpërdrejt — përgjigja e App Routerit ndaj formularëve dhe ndryshimeve të të dhënave.
Zvogëlojnë boilerplate-in, mundësojnë përmirësimin progresiv, dhe integrohen me ruajtjen në memorie/rivalidin, por (si çdo endpoint) kërkojnë vlefshmëri dhe kontrol autentikimi brenda tyre.