إجراءات الخادم في React 19 وNext.js

Server Actions هي دوال غير متزامنة تُنفذ على الخادم، وليس في المتصفح. ويُشار إليها بتوجيه 'use server' الموضوع في بداية الملف أو في بداية جسم الدالة، لإبلاغ إطار العمل بأن هذه الدالة يجب ألا تعمل على جانب العميل مطلقًا.

بما أن إجراءات الخادم تعمل على الخادم، فإنها تتمتع بإمكانية الوصول إلى سياق الخادم الكامل، بما في ذلك اتصالات قاعدة البيانات، وأسرار البيئة، وبيانات الجلسة، وموارد نظام الملفات. ويختلف هذا اختلافًا جوهريًا عن مكوّنات العميل التي لا يمكنها الوصول إلا إلى ما يتيحه المتصفح.

عندما يستدعي مكوّن عميل إجراءً من إجراءات الخادم، ينشئ Next.js تلقائيًا طلب HTTP من النوع POST إلى نقطة نهاية RSC خاصة. ويتولى الإطار جميع عمليات تسلسل الوسائط وطبقة النقل، لذلك لن تضطروا إلى كتابة استدعاءات fetch() يدويًا لعمليات التعديل هذه.

تغني إجراءات الخادم عن الحاجة إلى مسارات API في العديد من سيناريوهات تعديل البيانات. فالإجراء نفسه هو نقطة النهاية؛ إذ تعرّفون المنطق مرة واحدة على شكل دالة تعمل على الخادم، ثم تستدعونها مباشرةً من مكوّن العميل كما لو كانت دالة محلية.

كانت إجراءات الخادم في البداية مفهومًا خاصًا بـ Next.js، لكن React 19 يرفعها إلى ميزة أساسية في React. وهذا يعني أن أدوات التجميع والأطر الأخرى غير Next.js يمكنها تطبيق النمط نفسه وفقًا لمواصفات React.

تُعد إجراءات الخادم تجريبية في الإصدار المرشح من React 19، لكنها مستقرة في App Router في Next.js 14 والإصدارات الأحدث منذ تقديمها. وإذا كنتم تبنون تطبيقًا إنتاجيًا اليوم باستخدام App Router في Next.js، فإن إجراءات الخادم نمط مدعوم بالكامل وموصى به.

من أهم خصائص الأمان في إجراءات الخادم أن الأسرار لا تصل إلى المتصفح مطلقًا. فمتغيرات البيئة، مثل كلمات مرور قاعدة البيانات ومفاتيح API المستخدمة داخل إجراء من إجراءات الخادم، لا تُضمَّن مطلقًا في حزمة العميل، لأن جسم الدالة لا يُرسل إلى المتصفح أصلًا.

تقبل عناصر نماذج HTML إجراءً من إجراءات الخادم مباشرةً عبر السمة action: <form action={myServerAction}>. ويتولى React اعتراض إرسال النموذج واستدعاء إجراء الخادم باستخدام بيانات النموذج، مما يتيح تعديل البيانات على الخادم من دون كتابة أي كود JavaScript على جانب العميل لمعالجة ذلك.

عند تشغيل إجراء من إجراءات الخادم، يضع React وسائط الإجراء في صورة متسلسلة داخل نص طلب POST. ثم يلغي الخادم تسلسلها، وينفذ الدالة، ويضع القيمة المعادة في صورة متسلسلة، ويرسلها مرة أخرى. ولا يمكن عبور الحد الفاصل إلا للقيم القابلة للتسلسل، مثل السلاسل النصية والأرقام والمصفوفات والكائنات البسيطة.

يمكنكم تعريف إجراء من إجراءات الخادم على مستوى الوحدة في ملف يحتوي على 'use server' في أعلاه، أو تضمينه داخل مكوّن خادم بوضع 'use server' في أعلى الدالة غير المتزامنة. وينتج كلا الأسلوبين النتيجة نفسها: دالة قابلة للاستدعاء على الخادم فقط.

يستورد مكوّن العميل إجراءات الخادم ويستدعيها كما يستدعي الدوال غير المتزامنة العادية. وتكون صيغة الاستدعاء مطابقة تمامًا لاستدعاء دالة غير متزامنة محلية، لكن التنفيذ يحدث بالكامل على الخادم. ويحافظ هذا التجريد على نظافة مكوّنات العميل ويعفيها من التعليمات البرمجية المتكررة الخاصة بـ fetch.

أيّ العبارات التالية تصف نموذج الأمان الخاص بإجراءات الخادم بأفضل شكل؟

إجراءات الخادم هي دوال غير متزامنة تعمل على الخادم وتُوسم بـ 'use server'. وتحتفظ بإمكانية الوصول إلى سياق الخادم، مثل اتصالات قاعدة البيانات وأسرار البيئة. ويتولى Next.js نقل HTTP تلقائيًا، بينما يجعلها React 19 ميزة مستقلة عن الإطار. ويمكن للنماذج استخدامها مباشرةً عبر السمة action، كما أن الأسرار الموجودة داخلها لا تصل إلى المتصفح مطلقًا.