●Change8

Migrating to Webpack v5.102.0

Version v5.102.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 9/29/2025

2
Breaking Changes
3
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

snapshot.contextModuleextractSourceMapexperiments.topLevelAwaitexperiments.layers__non_webpack_require__createRequireAssetsByChunkName

Breaking Changes

●Issue #1

The topLevelAwait experiment is now stable. While not a breaking change in functionality, the configuration option experiments.topLevelAwait is no longer required.

●Issue #2

The layers experiment is now stable. The configuration option experiments.layers is no longer required.

Migration Steps

  1. 1
    Remove 'experiments.topLevelAwait' from webpack.config.js as it is now enabled by default.
  2. 2
    Remove 'experiments.layers' from webpack.config.js as it is now enabled by default.
  3. 3
    Consider replacing 'source-map-loader' with the native 'extractSourceMap' option.

Release Summary

This release stabilizes the topLevelAwait and layers experiments and introduces native support for 'bytes' and 'text' import attributes. It also adds a built-in extractSourceMap option to replace source-map-loader and includes several performance optimizations for snapshots and build dependencies.

Need More Details?

View the full release notes and all changes for Webpack v5.102.0.

View Full Changelog