معالجات المسارات
جزء من قسم أساسيات 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.
استخدم معالج المسارات عندما يحتاج المتصفح إلى البيانات عند الطلب، أو عندما يحتاج شيء خارج تطبيقك إلى الاتصال به. إذا كان بإمكان مكوّن الخادم قراءة البيانات أثناء العرض، فاتركه يفعل ذلك.
التحدي
متوسطأنشئ واجهة برمجة تطبيقات صغيرة واستدعها من المتصفح.
- في
app/api/dishes/route.js، صدّرasync function GETيعيدdishesبصيغة JSON. - في
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>
);
}يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس أساسيات Next.js
4الخادم والعميل
نوعان من المكوّناتقراءة رسالة الخطأسطر 'use client'اجعل أجزاء العميل صغيرةالخادم داخل العميلمراجعة: الخادم والعميل7التنقل بين صفحات العميل
الرابط النشطالتوجيه البرمجيالتصفية باستخدام URLمعالجات المساراتمراجعة: التنقل