Server Actions ná feidhmeanna neamhshioncronach a ritheann ar an bhfreastalaí ach is féidir a glaoch orthu go díreach ó do chomhpháirteanna (lena n-áirítear ó fhoirmeacha agus gnáthlámhaithe imeachta) — ag ligean duit athruithe a dhéanamh (cruthú/nuashonrú/scrios) gan API endpoint a thógáil de láimh. Marcáilíonn tú iad leis an "use server" treorach.
// 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>
);
}
Tuairiscíonn gníomhaireacht an fhoirmis ar an Server Action. Nuair a chuirtear an fhoirm ar aghaidh, seolann Next.js an FormData go dtí an freastalaí, ritheann sí an fheidhm ann, agus is féidir léi leathanaigh thionchar a athbhreithniú — ar fad gan API route agus gan chód fetch ar thaobh an chliaint.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts gnáthlámhaithe agus feidhmeanna clinteachta a scríobh.revalidatePath/revalidateTag athnuachan sonraí taiscéadh tar éis an athrú.⚠️ Server Actions are PUBLIC endpoints under the hood — always validate input and
check authorization inside them, exactly as you would a real API route.
Tumailt Server Actions an ghnáth-stoc athruithe (API route + feidhm chliaint + láimhseáil stáit) i bhfeidhm freastalaí amháin ar a bhfuil tú i ngleic go díreach — fregra an App Router ar fhoirmeacha agus athruithe sonraí.
Déanann siad an boilerplate a laghdú, cumasaíonn siad feidhmiú forásach, agus comhtháthaíonn siad le taiscéadh/athbhreithniú, ach (cosúil le pointe deireanach ar bith) éilíonn siad bailíochtú agus seiceanna fíordheimhnithe ar a n-inmheánaigh.