▲ مرجع Next.js بالعربي

'use client'

توجيه مكوّنات العميل

'use client' يعلن أن المكوّنات المُصدَّرة من هذا الملف تُصيَّر وتعمل بالمتصفح (Client Components)، وتُستخدم لأي تفاعل يحتاج state أو أحداث أو Browser APIs.

'use server'

توجيه دوال الخادم (Server Functions)

'use server' يعلّم دالة أو ملف كامل إنها تُنفَّذ على الخادم فقط — الأساس اللي تُبنى عليه Server Actions.

'use cache'

توجيه Cache Components

'use cache' يعلّم ملف أو مكوّن أو دالة إنها قابلة للتخزين المؤقّت ضمن نظام Cache Components الجديد في Next.js 16.

cacheLife()

تحديد مدّة التخزين المؤقّت

تحدّد مدّة صلاحية بيانات مخزَّنة داخل نطاق 'use cache' — إما ببروفايل جاهز (زي 'hours') أو كائن مخصّص بأرقام دقيقة.

cacheTag()

وسم بيانات مخزَّنة للإبطال الانتقائي

تضيف وسمًا (tag) لبيانات مخزَّنة داخل نطاق 'use cache'، عشان تقدر تبطلها لاحقًا بدون ما تلمس بقية الكاش.

revalidatePath()

إبطال التخزين المؤقّت لمسار محدّد

تبطل الكاش لمسار معيّن (صفحة أو تخطيط) عند الطلب، فيُعاد توليده بالزيارة القادمة.

revalidateTag()

إبطال التخزين المؤقّت حسب الوسم

تُعلِّم كل البيانات الموسومة بوسم معيّن أنها قديمة (stale)، فتُحدَّث بالخلفية بالزيارة القادمة لأي صفحة تستخدمها.

redirect()

إعادة توجيه المستخدم من الخادم

تُعيد توجيه المستخدم فورًا لمسار آخر — تُستخدم بمكوّنات الخادم وServer Functions وRoute Handlers.

notFound()

عرض صفحة 404 لمقطع مسار

توقف تصيير مقطع المسار الحالي وتعرض ملف not-found.tsx الأقرب، مع وسم الصفحة noindex لمحركات البحث.

useRouter()

التنقّل البرمجي من مكوّن عميل

خطاف (hook) يمنحك router.push/replace/refresh/back/forward للتنقّل من كود جافاسكربت داخل مكوّن عميل.

<Image>

مكوّن الصور المُحسَّنة next/image

يوسّع <img> بتحسين تلقائي: أحجام متجاوبة، صيغ حديثة (WebP/AVIF)، وتحميل كسول، لتفادي قفزة التخطيط (layout shift).

<Link>

التنقّل من جهة العميل مع Prefetch

يوسّع <a> بتنقّل من جهة العميل بدون إعادة تحميل كامل، وجلب مسبق (prefetch) تلقائي للمسارات الظاهرة بالشاشة.