مؤشرات التطوير (devIndicators)
devIndicators
تتيح لك تكوين المؤشر على الشاشة الذي يوفر سياقًا حول المسار الحالي الذي تشاهده أثناء التطوير.
devIndicators: false | {
position?: 'bottom-right'
| 'bottom-left'
| 'top-right'
| 'top-left', // الافتراضي هو 'bottom-left',
},
تعيين devIndicators
إلى false
سيخفي المؤشر، لكن Next.js سيستمر في عرض أي أخطاء بناء أو وقت تشغيل تمت مواجهتها.
استكشاف الأخطاء وإصلاحها
المؤشر لا يحدد المسار كمسار ثابت
إذا كنت تتوقع أن يكون المسار ثابتًا ولكن المؤشر قد حدده كمسار ديناميكي، فمن المحتمل أن المسار قد اختار عدم استخدام العرض الثابت.
يمكنك التأكد مما إذا كان المسار ثابتًا أو ديناميكيًا عن طريق بناء تطبيقك باستخدام next build --debug
، والتحقق من الناتج في طرفيتك. المسارات الثابتة (أو المقدمة مسبقًا) ستعرض رمز ○
، بينما المسارات الديناميكية ستعرض رمز ƒ
. على سبيل المثال:
Route (app) Size First Load JS
┌ ○ /_not-found 0 B 0 kB
└ ƒ /products/[id] 0 B 0 kB
○ (Static) prerendered as static content
ƒ (Dynamic) server-rendered on demand
هناك سببان قد يجعلان المسار يختار عدم استخدام العرض الثابت:
- وجود واجهات برمجة تطبيقات ديناميكية التي تعتمد على معلومات وقت التشغيل.
- طلب بيانات غير مخزن مؤقت، مثل استدعاء لـ ORM أو مشغل قاعدة بيانات.
تحقق من مسارك لأي من هذه الشروط، وإذا لم تتمكن من عرض المسار بشكل ثابت، ففكر في استخدام loading.js
أو <Suspense />
للاستفادة من البث.
سجل الإصدارات
الإصدار | التغييرات |
---|---|
v15.2.0 | تحسين المؤشر على الشاشة مع إضافة خيار position جديد. تم إيقاف خيارات appIsrStatus و buildActivity و buildActivityPosition . |
v15.0.0 | تمت إضافة مؤشر ثابت على الشاشة مع خيار appIsrStatus . |