Server Actions هي دوال غير متزامنة تعمل على الخادم ولكن يمكن استدعاؤها مباشرة من مكوناتك (بما في ذلك من النماذج ومعالجات الأحداث) — مما يتيح لك تنفيذ الطفرات (الإنشاء/التحديث/الحذف) دون بناء نقطة نهاية API يدويًا. تقوم بوضع علامة عليها باستخدام التوجيه "use server".
;
{ 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. عند الإرسال، يرسل Next.js FormData إلى الخادم، ويقوم بتشغيل الدالة هناك، ويمكنه إعادة التحقق من صحة الصفحات المتأثرة — كل ذلك بدون مسار API وبدون كود 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.
Server Actions تقوض مكدس الطفرة المعتاد (مسار API + عميل fetch + معالجة الحالة) إلى دالة خادم واحدة تستدعيها مباشرة — إجابة App Router على النماذج وتغييرات البيانات.
تقلل من المعالجات النمطية، وتمكّن التحسين التدريجي، وتتكامل مع التخزين المؤقت وإعادة التحقق من الصحة، لكن (مثل أي نقطة نهاية) تتطلب التحقق والتحقق من الهوية داخلها.