Server Actions అనేవి సర్వర్పై నిర్వహించే అసమకాలిక విధులు కానీ మీ భాగాల నుండి నేరుగా పిలవబడతాయి (ఫారమ్లు మరియు ఈవెంట్ హ్యాండ్లర్లతో సహా) — ఇది మీకు ఎపిఐ ఎండ్పాయింట్ను ఎటువంటి ఎపిఐ ఎండ్పాయింట్ నిర్మాణం లేకుండా (సృష్టించు/నవీకరణ/తొలగించు) ఎపిఐ ఎండ్పాయింట్ నిర్మాణం లేకుండా నిర్వహించడానికి అనుమతిస్తుంది. మీరు వాటిని "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 సర్వర్ యాక్షన్ను సూచిస్తుంది. సమర్పణపై, Next.js సర్వర్కు FormData పంపుతుంది, అక్కడ ఫంక్షన్ను నిర్వహిస్తుంది, మరియు ప్రభావితమైన పేజీలను రీవాలిడేట్ చేయవచ్చు — ఎపిఐ మార్గం లేకుండా మరియు క్లయింట్ సైడ్ fetch కోడ్ లేకుండా.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts హ్యాండ్లర్లు మరియు క్లయింట్ ఫెచ్లు రాయకుండా మ్యూటేషన్లు.revalidatePath/revalidateTag ఎపిఐ తర్వాత కాష్ చేయిన ఎపిఐ రీఫ్రెష్ చేస్తాయి.⚠️ Server Actions are PUBLIC endpoints under the hood — always validate input and
check authorization inside them, exactly as you would a real API route.
సర్వర్ యాక్షన్లు సాధారణ ఎపిఐ స్టాక్ను (ఎపిఐ మార్గం + క్లయింట్ ఫెచ్ + స్టేట్ హ్యాండ్లింగ్) ఒకే సర్వర్ ఫంక్షన్లో కూలిపోతాయి మీరు నేరుగా పిలుస్తారు — ఫారమ్లు మరియు ఎపిఐ మార్పులకు ఎపిఐ రౌటర్ సమాధానం.
వారు బొర్లర్ప్లేట్ను తగ్గిస్తారు, ప్రగతిశీల ఎనహాన్సమెంట్ ఎనేబుల్ చేస్తారు, మరియు కాష్/రీవాలిడేషన్తో ఇంటిగ్రేట్ చేస్తారు, కానీ (ఏదైనా ఎండ్పాయింట్ల వంటి) సరిబათ మరియు ఆథెంటికేషన్ చెక్ల అవసరం ఉంటుంది.