devIndicators
devIndicators
を使用すると、開発中に表示される現在のルート情報を提供する画面上のインジケーターを設定できます。
devIndicators
を false
に設定するとインジケーターは非表示になりますが、Next.js は引き続き発生したビルド時またはランタイムエラーを表示します。
トラブルシューティング
インジケーターがルートを静的としてマークしない場合
ルートが静的であると期待しているのにインジケーターが動的とマークしている場合、そのルートが静的レンダリングをオプトアウトしている可能性があります。
next build --debug
を使用してアプリケーションをビルドし、ターミナルの出力を確認することで、ルートが静的か動的かを確認できます。静的(またはプリレンダリングされた)ルートは ○
記号で表示され、動的ルートは ƒ
記号で表示されます。例:
ルートが静的レンダリングをオプトアウトする理由は主に2つあります:
- ランタイム情報に依存する動的APIの存在
- ORMやデータベースドライバーへの呼び出しなど、キャッシュされていないデータリクエスト
これらの条件に該当するかルートを確認し、静的レンダリングができない場合は、loading.js
や <Suspense />
を使用してストリーミングを活用することを検討してください。
バージョン履歴
バージョン | 変更内容 |
---|---|
v15.2.0 | 画面上インジケーターが改善され、新しい position オプションが追加されました。appIsrStatus 、buildActivity 、buildActivityPosition オプションは非推奨になりました。 |
v15.0.0 | appIsrStatus オプション付きの静的画面上インジケーターが追加されました。 |