Menu
CoddyTech

ما هي إجراءات الخادم؟

جزء من قسم أساسيات Next.js في رحلة React على Coddy. الدرس 29 من 47.

يمكنك الآن قراءة البيانات على الخادم. حان وقت النصف الآخر: تغييرها.

حتى وقت قريب، كان حفظ سطر واحد من النص يتطلب قدرًا مفاجئًا من الإجراءات. كنت تكتب نقطة نهاية:

// app/api/items/route.js
export async function POST(request) {
    const body = await request.json();
    saveItem(body.text);
    return Response.json({ ok: true });
}

…ثم استدعيناها من المتصفح:

await fetch('/api/items', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ text }),
});

ملفان، ورابط URL، وطريقة، وترويسات، وJSON في كلا الاتجاهين، لنقل سلسلة نصية واحدة من نموذج إلى قاعدة بيانات.

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

// app/actions.js
'use server';

import { saveItem } from '../lib/db';

export async function addItem(formData) {
    saveItem(formData.get('text'));
}

… ومرّر تلك الدالة إلى نموذج:

<form action={addItem}>
    <input name="text" />
    <button type="submit">Add</button>
</form>

هذا كل شيء. هناك ثلاث نقاط يجدر ذكرها:

  • يجب أن يكون 'use server' السطر الأول في الملف: فهو علامة من النوع نفسه مثل 'use client'، لكنها تشير إلى الاتجاه الآخر. وهي تعني أن كل ما يُصدَّر هنا يعمل على الخادم.
  • لا يصل جسم الدالة إلى المتصفح أبدًا. بيانات اعتماد قاعدة البيانات آمنة بداخلها: لا يحصل المتصفح إلا على مرجع يمكنه استدعاؤه.
  • لم تكتب عنوان URL مطلقًا. ينشئ Next.js نقطة النهاية نيابةً عنك؛ وaction={addItem} هو ما يربطها.

أحد أوجه الاختلاف عن الأساسيات: مدخلات النموذج هذه غير مُتحكَّم بها. لا يوجد useState، ولا value، ولا onChange: يحتفظ المتصفح بالنص، وتُستخدم سمة name لتتمكن الدالة من العثور عليه عند الإرسال.

جرّب بنفسك

لا يتضمّن هذا الدرس تحدّيًا برمجيًا.

quiz iconاختبر نفسك

يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.

جميع دروس أساسيات Next.js