Server Actions so asinkrone funkcije, ki se izvajajo na strežniku, vendar jih lahko neposredno pokličete iz svojih komponent (vključno iz obrazcev in rukovalek dogodkov) — kar vam omogoča izvajanje mutacij (ustvarjanje/posodabljanje/brisanje) brez ročnega gradnje končne točke API-ja. Označite jih z direktivo "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>
);
}
Akcija obrazca action kaže na Server Action. Pri oddaji Next.js pošlje FormData na strežnik, tam izvede funkcijo in lahko ponovno preveri vplivane strani — vse brez API poti in brez kode za fetch na strani odjemalca.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts in iskanja s strani odjemalca.revalidatePath/revalidateTag osvežita predpomnjenika podatke po mutaciji.⚠️ 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 sesutuvajo običajni kupi mutacij (API pot + iskanje s strani odjemalca + upravljanje stanja) v eno funkcijo na strežniku, ki jo pokličete neposredno — odgovor App Routerja na obrazce in spremembe podatkov.
Zmanjšajo šablonski kod, omogočajo progresivno izboljšanje in se integrirano z shranitvijo podatkov v pomnilniku in revalidacijo, vendar (kot katera koli končna točka) zahtevajo preverjanje in preverke avtentičnosti znotraj njih.