Menu
CoddyTech

معالجة الأخطاء

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

قد يفشل التحميل. قد تكون قاعدة البيانات متوقفة، أو يكون السجل مفقودًا، أو يحدث خطأ ما. من دون خطة، قد يؤدي await واحد سيئ إلى تعطيل الشاشة بأكملها.

error.jsx هو الصورة المعكوسة لـ loading.jsx: الفكرة نفسها، لكن النتيجة معاكسة. ضعه بجانب صفحة، وسيلتقط أي شيء تُلقيه تلك الصفحة أثناء العرض:

app/
    menu/
        page.jsx
        loading.jsx    while it works
        error.jsx      when it doesn't

على عكس loading.jsx، لديه متطلب واحد إلزامي:

'use client';

export default function Error({ error, reset }) {
    return (
        <div>
            <h2>Couldn't load the menu</h2>
            <button onClick={reset}>Try again</button>
        </div>
    );
}

يجب أن يكون error.jsx مكوّنًا للعميل. والسبب واضح في JSX: onClick. زر إعادة المحاولة يوفّر إمكانية التفاعل، والتفاعل يحتاج إلى مكوّن يُرسل إلى المتصفح. إذا لم تضف 'use client'، فستظهر لك رسالة خطأ معالج الأحداث من الفصل السابق، في الصفحة نفسها التي يفترض أن تتولى معالجة الأخطاء.

تستقبل خاصيتين:

  • error: الخطأ Error الذي تم طرحه، حتى تتمكن من تسجيله
  • reset: دالة تعيد عرض القسم الذي فشل. استدعها وستحاول الصفحة مرة أخرى

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

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

جرّب بنفسك

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

quiz iconاختبر نفسك

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

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