Server vs Client Components
متوسطما الذي يعمل على الخادم وما الذي يعمل في المتصفح: مكوّن خادم يجلب البيانات، وزر "use client"، وHTML وحمولة RSC، والإنعاش (hydration).يعتمد على What happens when state changes, What happens when you type a URL
فارغ
Spaceتشغيل أو إيقاف←→الخطوة السابقة أو التاليةRالعودة إلى البداية
الشرح
وقت القراءة: 3 د
في هذه الصفحة
ما هي مكوّنات الخادم ومكوّنات العميل في Next.js؟
في App Router، كل مكوّن هو مكوّن خادم (Server Component) ما لم تقل غير ذلك. ومكوّن الخادم يعمل
على الخادم فقط: يمكن أن يكون async، ويقرأ قاعدة بيانات أو ملفًا، ويستخدم الأسرار، ولا يُرسل كوده
إلى المتصفح أبدًا. وما يُرسله هو ناتجه.
أما مكوّن العميل (Client Component) فهو الذي يحتاج إلى المتصفح: الحالة (useState)، أو
التأثيرات، أو معالجات الأحداث مثل onClick، أو واجهات المتصفح. وتعلّم ملفه بـ 'use client' في
أعلاه. وتُحوَّل مكوّنات العميل أيضًا إلى HTML على الخادم في التحميل الأول، لذا فـ «العميل» لا تعني
«في المتصفح فقط»؛ بل تعني أن كوده يُرسل إلى المتصفح أيضًا ليعمل هناك.
ما الذي يعمل وأين عند تحميل الصفحة؟
- على الخادم يعرض React مكوّنات الخادم ويضع ناتجها في حمولة RSC (RSC payload): الناتج المعروض، ومكانًا محجوزًا لكل مكوّن عميل، والخصائص الممرَّرة إليه، ومرجعًا إلى ملف JavaScript الخاص به. ومع مكوّنات العميل، تُستخدم هذه الحمولة لتجهيز HTML مسبقًا.
- في المتصفح يعرض HTML الصفحة فورًا، قبل تشغيل أي JavaScript.
- يُنزّل المتصفح JavaScript الخاص بمكوّنات العميل فقط ثم ينعشها (hydration): يشغّلها React من جديد، ويطابقها مع HTML الموجود على الشاشة، ويربط معالجات أحداثها.
- بعد ذلك تعمل التفاعلات داخل مكوّن العميل، مثل النقر على الزر، في المتصفح. ولا حاجة إلى أي طلب للخادم ما لم يُرسل كودك طلبًا.
و'use client' تحدّد . فكل ما يستورده ذلك الملف، وكل مكوّن يعرضه مباشرة، يصبح
جزءًا من حزمة العميل. أما المكوّنات الواقعة فوق الحد فتبقى على الخادم.
ما الأخطاء الشائعة مع مكوّنات الخادم والعميل؟
مثال مصغّر
يبقى Comments مكوّن خادم رغم أنه يُعرض داخل Collapsible التفاعلي: فالصفحة تعرضه على الخادم
وتمرّر الناتج كـ children.
// app/page.tsx: a Server Componentexport default function Page() { return ( <Collapsible> <Comments /> </Collapsible> );}// app/collapsible.tsx'use client'; export function Collapsible({ children }: { children: React.ReactNode }) { const [open, setOpen] = useState(false); return ( <section> <button onClick={() => setOpen(!open)}>Comments</button> {open && children} </section> );}اختبر نفسك
أيٌّ مما يلي يمكن لمكوّن خادم تمريره كـ prop إلى مكوّن عميل؟
للمزيد من القراءة
كل الخطوات كنص
- الخطوة 1:
تفتح الصفحة. فيُرسل المتصفح طلبًا للمسار / إلى خادم Next.js.
- الخطوة 2:
على الخادم يشغّل React المكوّن Page، وهو مكوّن خادم (Server Component). وهو دالة غير متزامنة، لذا يمكنه انتظار البيانات مباشرة.
الأسطر 3–4
- الخطوة 3:
تقرأ
getPostالمنشور مباشرة من قاعدة البيانات. فالمتصفح لا يتحدّث أبدًا مع قاعدة البيانات، ولا يستلم هذا الكود.السطر 4
- الخطوة 4:
يُعيد Page عنصر article بداخله LikeButton. وLikeButton مكوّن عميل (Client Component): يُحوَّل إلى HTML هنا أيضًا، لكن كوده سيذهب إلى المتصفح كذلك.
الأسطر 5–10
- الخطوة 5:
تحمل الاستجابة HTML وحمولة RSC (RSC payload): ناتج Page، ومكانًا محجوزًا لـ LikeButton، وخصائصه، وموقع كوده.
الأسطر 6–8
- الخطوة 6:
يعرض المتصفح HTML فورًا: العنوان و
♥ 3على الشاشة، لكن الزر لا يستجيب بعد. - الخطوة 7:
ثم يُنزّل JavaScript، لكن لمكوّنات العميل فقط: كود LikeButton، ومعه React. أما كود Page فيبقى على الخادم.
الأسطر 13–15
- الخطوة 8:
الإنعاش (hydration): يشغّل React المكوّن LikeButton في المتصفح مع
likes = 3من الحمولة، ويربط معالج النقر بالزر الموجود على الشاشة.الأسطر 16–18
- الخطوة 9:
تنقر. فتعمل
setCountفي المتصفح ويُظهر الزر♥ 4، دون أي طلب إلى الخادم.السطر 19
- الخطوة 10:
مكوّنات الخادم تعمل على الخادم فقط وتُرسل ناتجها. أما مكوّنات العميل فتُرسل كودها أيضًا، لتعمل في المتصفح وتستجيب لك.