devIndicators

devIndicators を使用すると、開発中に表示される現在のルート情報を提供する画面上のインジケーターを設定できます。

Types
  devIndicators: false | {
    position?: 'bottom-right'
    | 'bottom-left'
    | 'top-right'
    | 'top-left', // デフォルトは 'bottom-left'
  },

devIndicatorsfalse に設定するとインジケーターは非表示になりますが、Next.js は引き続き発生したビルド時またはランタイムエラーを表示します。

トラブルシューティング

インジケーターがルートを静的としてマークしない場合

ルートが静的であると期待しているのにインジケーターが動的とマークしている場合、そのルートが静的レンダリングをオプトアウトしている可能性があります。

next build --debug を使用してアプリケーションをビルドし、ターミナルの出力を確認することで、ルートが静的動的かを確認できます。静的(またはプリレンダリングされた)ルートは 記号で表示され、動的ルートは ƒ 記号で表示されます。例:

Build Output
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

ルートが静的レンダリングをオプトアウトする理由は主に2つあります:

  1. ランタイム情報に依存する動的APIの存在
  2. ORMやデータベースドライバーへの呼び出しなど、キャッシュされていないデータリクエスト

これらの条件に該当するかルートを確認し、静的レンダリングができない場合は、loading.js<Suspense /> を使用してストリーミングを活用することを検討してください。

バージョン履歴

バージョン変更内容
v15.2.0画面上インジケーターが改善され、新しい position オプションが追加されました。appIsrStatusbuildActivitybuildActivityPosition オプションは非推奨になりました。
v15.0.0appIsrStatus オプション付きの静的画面上インジケーターが追加されました。

On this page