devIndicators
devIndicators
ermöglicht die Konfiguration des Bildschirm-Indikators, der während der Entwicklung Kontext zur aktuell angezeigten Route bereitstellt.
devIndicators: false | {
position?: 'bottom-right'
| 'bottom-left'
| 'top-right'
| 'top-left', // Standardwert ist 'bottom-left',
},
Wenn devIndicators
auf false
gesetzt wird, wird der Indikator ausgeblendet. Next.js zeigt jedoch weiterhin auftretende Build- oder Laufzeitfehler an.
Fehlerbehebung
Indikator markiert Route nicht als statisch
Falls eine Route statisch sein sollte, der Indikator sie aber als dynamisch markiert, hat die Route wahrscheinlich das statische Rendering deaktiviert.
Sie können überprüfen, ob eine Route statisch oder dynamisch ist, indem Sie Ihre Anwendung mit next build --debug
erstellen und die Ausgabe im Terminal prüfen. Statische (oder vorgerenderte) Routen werden mit einem ○
-Symbol angezeigt, während dynamische Routen ein ƒ
-Symbol verwenden. Beispiel:
Route (app) Size First Load JS
┌ ○ /_not-found 0 B 0 kB
└ ƒ /products/[id] 0 B 0 kB
○ (Statisch) als statischer Inhalt vorgerendert
ƒ (Dynamisch) bei Bedarf serverseitig gerendert
Es gibt zwei Gründe, warum eine Route das statische Rendering deaktivieren könnte:
- Die Verwendung von Dynamischen APIs, die von Laufzeitinformationen abhängen.
- Eine nicht zwischengespeicherte Datenanfrage, wie ein Aufruf eines ORM oder Datenbanktreibers.
Überprüfen Sie Ihre Route auf diese Bedingungen. Falls Sie die Route nicht statisch rendern können, erwägen Sie die Verwendung von loading.js
oder <Suspense />
, um Streaming zu nutzen.
Versionsverlauf
Version | Änderungen |
---|---|
v15.2.0 | Verbesserter Bildschirm-Indikator mit neuer position -Option. Die Optionen appIsrStatus , buildActivity und buildActivityPosition sind veraltet. |
v15.0.0 | Statischer Bildschirm-Indikator mit appIsrStatus -Option hinzugefügt. |