راهنمای جامع Server Actions در Next.js 15 و تفاوت با API Routes سنتی

#چرا Server Actions آینده توسعه وب است؟

در اکوسیستم مدرن ری‌اکت و نکست‌جی‌اس، مفهوم Server Actions یکی از انقلابی‌ترین تحولات چند سال اخیر به شمار می‌رود. پیش از معرفی این قابلیت، توسعه‌دهندگان ناچار بودند برای کوچک‌ترین عملیات ارسال داده (مانند ثبت یک فرم یا تغییر وضعیت لاگین)، یک اندپوینت API مجزا در پوشه

app/api

fetch

اما با Server Actions، مرز میان کلاینت و سرور به شکل هوشمندانه‌ای یکپارچه شده است:

typescript
content_copyکپی کد
"use server";

import { revalidatePath } from "next/cache";
import { prisma } from "@/server/db/prisma";

export async function updateUsername(userId: string, newName: string) {
  if (!newName.trim() || newName.length < 3) {
    return { success: false, error: "نام کاربری نامعتبر است." };
  }

  await prisma.user.update({
    where: { id: userId },
    data: { fullName: newName.trim() },
  });

  revalidatePath("/profile");
  return { success: true };
}

##۳ مزیت کلیدی استفاده از Server Actions:

1. کاهش چشمگیر حجم باندل جاوااسکریپت کلاینت: کدهای منطقی سمت سرور باقی می‌مانند و مرورگر کاربر نیازی به دانلود کتابخانه‌های سنگین ندارد.
2. سازگاری خودکار با فرم‌های پیش‌فرض وب: حتی بدون فعال بودن جاوااسکریپت در مرورگر، فرم‌های دارای Server Action قابلیت ارسال و ثبت اطلاعات دارند (Progressive Enhancement).
3. بازاعتبارسنجی (Revalidation) خودکار کش: با فراخوانی تابع
   content_copyکپی کد

   revalidatePath

   یا
   content_copyکپی کد

   revalidateTag

   ، داده‌های صفحه در کسری از ثانیه به‌روز می‌شوند بدون اینکه نیازی به رفرش صفحه باشد.

نکته امنیتی مهم: همواره به یاد داشته باشید که Server Actions در نهایت یک اندپوینت POST روی سرور ایجاد می‌کنند. بنابراین احراز هویت کاربر و بررسی سطوح دسترسی (RBAC) در خط اول هر تابع سرور اکشن الزامی است.

##جمع‌بندی

استفاده درست از Server Actions کدنویسی شما را تمیزتر، معماری پروژه را یکدست‌تر و تجربه کاربری (UX) نهایی را فوق‌العاده سریع‌تر خواهد کرد.