概要

nuxt dev 実行時(開発サーバー)のエラー表示まわり。danielroe/my-bad を土台にしたエラーレポートの仕組みがあり、SSR のスタックトレースをソースの位置・コードフレームまで正しくマッピングして表示する。エラーレポートはリモートの peer(Docker 上の dev サーバーなど)向けにもスコープを分けてストリーミングできる。nitro・vite-server 両方のビルダーで使うエラー処理は createDevErrorReporter() などとして共通化されている。開発用のエラーチャンネルは本番ビルドには含まれない。クライアント側のエラーオーバーレイは、event.error が null のブラウザ通知(ResizeObserver のループ制限など)では開かない。

主な API・オプション

  • nitroApp.ssrSourceMaps(getSourceMap・getCode など)— マッピング済みのソースマップを Nitro 側に公開する
  • createDevErrorReporter() — nitro・vite-server の各ビルダーが提供するエラーレポーター
  • ssrFixStacktrace — SSR のスタックトレースを修正する内部処理
  • dev-error-overlay.client.ts — 開発時にクライアントのエラーを全画面表示するオーバーレイ(プラグイン)

変更履歴

  • 2026-09-26 — error を持たないブラウザの通知(ResizeObserver のループ制限など)でエラーオーバーレイを開かないよう修正(#36415)⏳ 未リリース · 変更
  • 2026-09-24 — 開発用のエラーチャンネルを本番ビルドから除外(#36407)⏳ 未リリース · 変更
  • 2026-09-23 — nitro・vite-server 間でエラー処理を共通化し createDevErrorReporter() を導入(refactor)(#36398)⏳ 未リリース · 変更
  • 2026-09-22 — 開発時のエラーレポートをリモート peer 向けにスコープ可能に(#36389)⏳ 未リリース · 変更
  • 2026-09-22 — 開発時の SSR スタックトレースをソースへ正しくマッピング(#36258)⏳ 未リリース · 変更
  • 2026-09-19 — ssrFixStacktrace を await するよう修正(クラッシュ対策)(#36372)⏳ 未リリース · 変更

関連