connection و cookies در Next.js — کنترل رندر داینامیک و مدیریت کوکی‌ها در کامپوننت‌های سروری

تابع connection در Next.js به شما اجازه می‌دهد رندر کامپوننت را تا زمان دریافت درخواست واقعی کاربر به تعویق بیندازید. این قابلیت برای داده‌هایی مانند تاریخ یا عدد تصادفی مفید است که نباید در زمان build تولید شوند. همچنین API کوکی‌ها در Next.js امکان خواندن کوکی‌ها در Server Components و خواندن/نوشتن آن‌ها در Server Actions و Route Handlers را فراهم می‌کند. این مقاله نحوه استفاده از هر دو قابلیت را با مثال‌های کاربردی توضیح می‌دهد.

connectioncookiesdynamic renderingServer Actions

~2 دقیقه مطالعه · آخرین به‌روزرسانی ۹ آبان ۱۴۰۴

۱. تابع connection چیست؟


connection() تابعی در Next.js است که باعث می‌شود رندر کامپوننت تا زمان دریافت درخواست واقعی کاربر به تعویق بیفتد. این تابع برای مواقعی مناسب است که از APIهای داینامیک استفاده نمی‌کنید، اما می‌خواهید خروجی در زمان اجرا تولید شود.


مثال:

// app/page.tsx
import { connection } from 'next/server'

export default async function Page() {
  await connection()
  const rand = Math.random()
  return <span>{rand}</span>
}

در این مثال، مقدار Math.random() در زمان اجرا تولید می‌شود و از prerendering حذف می‌شود.


۲. API کوکی‌ها در Next.js


تابع cookies() امکان خواندن کوکی‌های ورودی در Server Components و خواندن/نوشتن کوکی‌های خروجی در Server Actions و Route Handlers را فراهم می‌کند.


خواندن یک کوکی:

const cookieStore = await cookies()
const theme = cookieStore.get('theme')

خواندن همه کوکی‌ها:

cookieStore.getAll().map((cookie) => (
  <div key={cookie.name}>
    <p>Name: {cookie.name}</p>
    <p>Value: {cookie.value}</p>
  </div>
))

بررسی وجود کوکی:

const hasCookie = cookieStore.has('theme')

تنظیم کوکی (فقط در Server Action یا Route Handler):

cookieStore.set('name', 'lee', { secure: true })

حذف کوکی:

  • cookieStore.delete('name')
  • cookieStore.set('name', '')
  • cookieStore.set('name', 'value', { maxAge: 0 })

۳. نکات مهم درباره کوکی‌ها


  • تابع cookies() در نسخه ۱۵ به صورت async طراحی شده است
  • استفاده از cookies باعث داینامیک شدن مسیر می‌شود
  • تنظیم یا حذف کوکی فقط در Server Action یا Route Handler ممکن است
  • کوکی‌ها در سمت کلاینت ذخیره می‌شوند؛ سرور فقط دستور ذخیره را ارسال می‌کند

۴. رفتار کوکی‌ها در Server Actions


پس از تنظیم یا حذف کوکی در Server Action، Next.js صفحه و layoutهای مرتبط را مجدد رندر می‌کند تا UI با مقدار جدید هماهنگ شود. برای تازه‌سازی کش نیز می‌توان از revalidatePath یا revalidateTag استفاده کرد.


جمع‌بندی


تابع connection() به شما امکان می‌دهد رندر را به زمان درخواست واقعی موکول کنید، و API کوکی‌ها در Next.js ابزار قدرتمندی برای مدیریت وضعیت کاربر در سمت سرور فراهم می‌کند. با استفاده درست از این دو قابلیت، می‌توانید تجربه‌ای پویا و امن برای کاربران بسازید.


نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

مسیریابی پیشرفته و هوک‌های عملکرد در Next.js — راهنمای توسعه‌دهنده برای App Router

Next.js مجموعه‌ای غنی از هوک‌های کلاینت و ابزارهای کش و ناوبری را در اختیار توسعه‌دهندگان قرار می‌دهد. از خواندن پارامترهای مسیر تا گزارش Web Vitals و مدیریت کش، این مقاله مهم‌ترین ابزارهای App Router را با مثال‌های کاربردی معرفی می‌کند.

ادامه

مدیریت احراز هویت و کش در Next.js — راهنمای توسعه‌دهنده برای امنیت و عملکرد پویا

Next.js با معرفی قابلیت‌های آزمایشی جدید، امکان کنترل دقیق‌تر دسترسی و کش داده‌ها را فراهم کرده است. تابع unauthorized برای مدیریت خطای 401 و هدایت کاربران به صفحه ورود، unstable_cache برای کش هوشمند عملیات سنگین، updateTag برای بازسازی آنی داده‌ها، و useLinkStatus برای نمایش وضعیت ناوبری استفاده می‌شوند. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات مهم بررسی می‌کند.

ادامه

redirect و refresh در Next.js — ریدایرکت‌های هوشمند و تازه‌سازی مسیر در Server Actions

تابع redirect در Next.js برای هدایت کاربر به مسیر جدید استفاده می‌شود و بسته به نوع استفاده، پاسخ HTTP با وضعیت 307 یا 303 ارسال می‌کند. این تابع در Server Components، Client Components، Route Handlers و Server Actions قابل استفاده است. تابع refresh نیز برای تازه‌سازی مسیر کلاینت از درون Server Action استفاده می‌شود. این مقاله نحوه استفاده از هر دو تابع را با مثال‌های کاربردی و نکات مهم توضیح می‌دهد.

ادامه

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

Next.js با معرفی NextRequest و NextResponse، APIهای Request و Response مرورگر را گسترش داده و ابزارهای قدرتمندی برای مدیریت کوکی‌ها، هدرها، ریدایرکت‌ها، بازنویسی مسیرها و پاسخ‌های JSON فراهم کرده است. این مقاله نحوه استفاده از این ابزارها را با مثال‌های کاربردی و نکات امنیتی توضیح می‌دهد.

ادامه

headers، ImageResponse، notFound و permanentRedirect در Next.js — مدیریت درخواست‌ها، تولید تصویر، خطا و ریدایرکت

Next.js ابزارهای قدرتمندی برای مدیریت درخواست‌ها و پاسخ‌ها در کامپوننت‌های سروری فراهم کرده است. تابع headers برای خواندن هدرهای HTTP ورودی، ImageResponse برای تولید تصاویر داینامیک، notFound برای نمایش صفحه خطای 404، و permanentRedirect برای ریدایرکت دائمی کاربران استفاده می‌شوند. این مقاله نحوه استفاده از هر یک را با مثال‌های کاربردی توضیح می‌دهد.

ادامه

راهنمای کامل استفاده از metadata و generateMetadata در Next.js

در نسخه‌های مدرن Next.js، مدیریت metadata صفحات بسیار قدرتمندتر و ساده‌تر شده است. metadata به‌صورت خودکار در تگ <head> صفحات تزریق می‌شود و نقش مهمی در SEO، اشتراک‌گذاری اجتماعی و تجربه کاربری دارد. این مقاله دو روش اصلی تعریف metadata را بررسی می‌کند: استفاده از آبجکت ثابت metadata و تابع داینامیک generateMetadata.

ادامه