Server Actions sune aiki-aiki masu jijiya da suke tsinkayi akan server amma za a iya kira su kai tsaye daga abubuwan ku (gami da niyoyi da handler-handler na abubuwan da suka faru) — suna ba da dama ka yin sauye-sauye (ƙirƙira/sabunta/gida) ba tare da ginawa API endpoint ta hannu ba. Ka alamta su da "use server" jagora.
// 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>
);
}
Niyar foron ta nuna Server Action. Lokacin ƙaura, Next.js yana aika FormData zuwa server, yana tsinkayi aiki a can, kuma yana iya sake baje buɗi shafukan da suke da tasiri — duk ba tare da API sari ba kuma ba tare da code fetch na gida ba.
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts masu gudatarwa da client fetch ba.revalidatePath/revalidateTag sake kusantar baƙon data a gida sauyen.⚠️ 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 suka nutse jujjuyawar aƙalla (API sari + client fetch + gudun jihar) cikin aiki-server gida ɗaya ka kira kai tsaye — sashe App Router zuwa niyoyi da sauyen bayanai.
Suna rage sakin sakin, suna ba da dama ga ci gaba na fuskanci, kuma suna tattara tare da bantuwa/sake baje buɗin, amma (kamar kowane gabani) suna buƙatar baje buɗin da amintaccen baje buɗin a ciki.