v6からの移行

Node.jsのサポート

ViteはEOLに達したNode.js 18をサポートしなくなりました。Node.js 20.19+ / 22.12+ が必要です。

デフォルトのブラウザターゲットの変更

build.target のデフォルトのブラウザ値が、新しいブラウザに更新されました。

• Chrome 87 → 107
• Edge 88 → 107
• Firefox 78 → 104
• Safari 14.0 → 16.0

これらのブラウザバージョンは、2025-05-01時点でのBaseline Widely Available 機能セットと一致します。つまり、それらはすべて2022-11-01以前にリリースされたものです。

Vite 5では、デフォルトのターゲットは'modules'という名前でしたが、これは利用できなくなりました。代わりに、新しいデフォルトターゲット'baseline-widely-available'が導入されました。

一般的な変更点

SassレガシーAPIのサポートを削除

計画通り、SassレガシーAPIのサポートは削除されました。ViteはモダンAPIのみをサポートします。css.preprocessorOptions.sass.api / css.preprocessorOptions.scss.api オプションを削除できます。

非推奨機能の削除

• splitVendorChunkPlugin (v5.2.7で非推奨)
  • このプラグインは元々Vite v2.9への移行を容易にするために提供されていました。
  • 必要に応じて、チャンクの分割動作を制御するためにbuild.rollupOptions.output.manualChunksオプションを使用できます。
• transformIndexHtmlにおけるフックレベルのenforce / transform (v4.0.0で非推奨)
  • インターフェースをRollupのオブジェクトフックに合わせるために変更されました。
  • enforceの代わりにorderを、transformの代わりにhandlerを使用する必要があります。

詳細

ごく一部のユーザーにのみ影響するその他の破壊的変更があります。

• [#19979] chore: peer dependencies のバージョン範囲を宣言
  • CSSプリプロセッサのピア依存関係のバージョン範囲が指定されました。
• [#20013] refactor: no-op legacy.proxySsrExternalModules を削除
  • legacy.proxySsrExternalModules プロパティはVite 6以降効果がありませんでした。削除されました。
• [#19985] refactor!: 非推奨の no-op 型のみのプロパティを削除
  • 以下の未使用のプロパティが削除されました: ModuleRunnerOptions.root, ViteDevServer._importGlobMap, ResolvePluginOptions.isFromTsImporter, ResolvePluginOptions.getDepsOptimizer, ResolvePluginOptions.shouldExternalize, ResolvePluginOptions.ssrConfig
• [#19986] refactor: 非推奨の env api プロパティを削除
  • これらのプロパティは当初から非推奨でした。削除されました。
• [#19987] refactor!: 非推奨の HotBroadcaster 関連の型を削除
  • これらの型は、現在非推奨のランタイムAPIの一部として導入されました。削除されました: HMRBroadcaster, HMRBroadcasterClient, ServerHMRChannel, HMRChannel
• [#19996] fix(ssr)!: ssr 変換されたコードで Object 変数にアクセスしない
  • __vite_ssr_exportName__ がモジュールランナーランタイムコンテキストで必要になりました。
• [#20045] fix: すべての optimizeDeps.entries の値をグロブとして扱う
  • optimizeDeps.entries はリテラル文字列パスを受け取らなくなりました。代わりに、常にグロブを受け取ります。
• [#20222] feat: configureServer フックの前にいくつかのミドルウェアを適用, [#20224] feat: configurePreviewServer フックの前にいくつかのミドルウェアを適用
  • configureServer / configurePreviewServer フックの前にいくつかのミドルウェアが適用されるようになりました。特定のルートにserver.cors / preview.cors オプションを適用したくない場合は、レスポンスから関連するヘッダーを削除するようにしてください。

v5からの移行

まず、Vite v6 ドキュメントのv5 からの移行ガイドを確認し、アプリを Vite 6 に移植するために必要な変更を把握してから、このページの変更に進んでください。