Menu
CoddyTech

معالجات المسارات

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

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

يصبح المجلد الذي يحتوي على route.js هو هذا المسار بالضبط. قاعدة التوجيه نفسها المستخدمة مع الصفحات، لكن بملف خاص مختلف:

app/
    api/
        dishes/
            route.js     ->  /api/dishes

في الداخل، تُصدّر دالةً اسمها مطابق لاسم طريقة HTTP:

import { dishes } from '../../../lib/dishes.js';

export async function GET() {
    return Response.json(dishes);
}

Response.json(...) هو الرد كاملًا: فهو يحوّل القيمة إلى تسلسل ويضبط نوع محتوى JSON. يمكنك أيضًا تصدير POST وPUT وDELETE من الملف نفسه.

ثم يكون النصف الخاص بالعميل شيفرة متصفح عادية:

const res = await fetch('/api/dishes');
const data = await res.json();

هناك أمران يجب تذكّرهما. يمكن للمجلد أن يحتوي على page.jsx أو على route.js، وليس كليهما أبدًا: فكلاهما سيطالب بعنوان URL نفسه. وroute.js ليس مكوّنًا: فهو يُرجع Response، وليس JSX.

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

challenge icon

التحدي

متوسط

أنشئ واجهة برمجة تطبيقات صغيرة واستدعها من المتصفح.

  1. في app/api/dishes/route.js، صدّر async function GET يعيد dishes بصيغة JSON.
  2. في components/DishLoader.jsx، أكمل loadDishes: اجلب /api/dishes، واقرأ محتوى JSON، وخزّن أسماء الأطباق باستخدام setNames.

يجب أن يؤدي النقر على #load-btn إلى ملء #dish-list بالأسماء الأربعة كلها.

جرّب بنفسك

import './globals.css';

export const metadata = {
    title: 'My App',
};

export default function RootLayout({ children }) {
    return (
        <html lang="en">
            <body>
                {children}
            </body>
        </html>
    );
}
quiz iconاختبر نفسك

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

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