Next.js アップグレード は何をしますか?
現在のプロジェクトを、公式の移行ガイドに従って最新の Next.js バージョンにアップグレードします。
手順
-
現在のバージョンを検出する:
package.jsonを読み取り、現在の Next.js バージョンと関連する依存関係(React、React DOM など)を特定します。 -
最新のアップグレードガイドを取得する: WebFetch を使用して公式のアップグレードドキュメントを取得します。
-
アップグレードパスを決定する: 現在のバージョンに基づいて、適用すべき移行手順を特定します。メジャーバージョンが複数離れている場合は、段階的にアップグレードします(例: 13 → 14 → 15)。
-
まずコードモッドを実行する: Next.js は破壊的変更を自動化するコードモッドを提供しています。
npx @next/codemod@latest <transform> <path>よく使われるトランスフォーム:
next-async-request-api- 非同期 Request API を更新(v15)next-request-geo-ip- geo/ip プロパティを移行(v15)next-dynamic-access-named-export- 動的インポートを変換(v15)
-
依存関係を更新する: Next.js とピア依存関係をまとめてアップグレードします。
npm install next@latest react@latest react-dom@latest -
破壊的変更を確認する: アップグレードガイドで手動変更が必要な箇所を確認します。
- API の変更(例: v15 での async params)
next.config.jsの設定変更- 削除される非推奨機能
-
TypeScript の型定義を更新する(該当する場合):
npm install @types/react@latest @types/react-dom@latest -
アップグレードをテストする:
npm run buildを実行してビルドエラーを確認npm run devを実行して主要機能をテスト