Server Actions غیر مطابقت والے functions ہیں جو سرور پر چلتے ہیں لیکن براہ راست آپ کے components سے کال کیے جا سکتے ہیں (forms اور event handlers سے بھی) — آپ کو mutations (create/update/delete) انجام دینے کی اجازت دیتے ہیں بغیر دستی طور پر API endpoint بنائے۔ آپ انہیں "use server" directive کے ساتھ نشان زد کرتے ہیں۔
;
{ revalidatePath } ;
() {
title = formData.() ;
db..({ : { title } });
();
}
// 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 Server Action کی طرف اشارہ کرتی ہے۔ submit پر، Next.js FormData کو سرور کو بھیجتا ہے، وہاں function چلاتا ہے، اور متاثرہ صفحات کو دوبارہ منظم کر سکتا ہے — سب کچھ API route اور client-side fetch code کے بغیر۔
"use client";
import { createTodo } from "./actions";
export function AddButton() {
return <button onClick={() => createTodo(/* ... */)}>Add</button>;
}
route.ts handlers اور client fetches لکھے۔revalidatePath/revalidateTag mutation کے بعد cached ڈیٹا کو تازہ کرتے ہیں۔⚠️ 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 عام mutation stack (API route + client fetch + state handling) کو ایک single server function میں سمیٹتے ہیں جو آپ براہ راست کال کرتے ہیں — App Router کا جواب forms اور data changes کے لیے۔
یہ boilerplate کو کم کرتے ہیں، progressive enhancement کو فعال کرتے ہیں، اور caching/revalidation کے ساتھ integrate ہوتے ہیں، لیکن (کسی بھی endpoint کی طرح) ان میں validation اور auth checks کی ضرورت ہے۔