Skip to content

docs: document the webpack 5.110.0 configuration and API surface - #8337

Merged
bjohansebas merged 11 commits into
mainfrom
docs/webpack-5-110
Aug 28, 2026
Merged

docs: document the webpack 5.110.0 configuration and API surface#8337
bjohansebas merged 11 commits into
mainfrom
docs/webpack-5-110

Conversation

@bjohansebas

Copy link
Copy Markdown
Member

Documents the configuration and API surface added in webpack 5.110.0 (webpack/webpack#21545).

Everything here was checked against the schema and the implementation on webpack@main, not against the changeset summaries.

What is documented

Area Content
configuration/performance performance.all, hints: "stats" and the 31 new opt-in checks, each with its default and its rationale, plus an overview table grouping them by what they inspect and a note on which ones are not gated on hints
configuration/module Rule.glob (pattern syntax, ! negation, use inside a Condition object) and Rule.descriptionRelativePath
configuration/externals externalsPresets.nodeModules and its allowlist, which replace webpack-node-externals, and the { external, sideEffects } value form. Also fills in the bun and deno preset rows the table was missing
configuration/output [containedfile] / [containedpath] placeholders, output.library.umdAmdContainer, output.resourceHints.dedupe, and the deferImport / sourceImport environment flags
configuration/optimization optimization.minimize as an object: javascript, css (14 options) and html (18 options), with defaults and when each minifier runs
configuration/entry-context the entry descriptor's html option, including the object form that overrides output.html per option
configuration/stats stats.hints and stats.hintsCount
api/module-variables, api/node, api/compilation-hooks __webpack_css_server_styles__, the MultiCompiler hooks (shutdown, and done reporting which compilers rebuilt), renderEmbeddedSource and embeddedSourceHash
configuration/experiments the HTML <head> is now patched in place on hot update instead of forcing a full reload

Left out

Release items with no configuration surface: resolve errors suggesting the closest name, the CSS/HTML printer internals, CommonJS tree shaking, and the parser performance work. Those belong in the release blog post, which comes as a separate PR on top of this branch.

Notes

  • markdownlint and prettier pass; the 39 new internal links were checked to resolve to a real file and anchor.
  • vale was not run locally.

bjohansebas and others added 9 commits August 26, 2026 20:54
Adds performance.all, hints: "stats" and the opt-in checks introduced in
webpack 5.110.0, plus an overview table grouping them by what they
inspect and a note on which ones are not gated on hints.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Both conditions land in webpack 5.110.0: glob matches the resource
OS-independently and is also accepted inside a Condition object, and
descriptionRelativePath matches a module by its path inside its own
package.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Covers externalsPresets.nodeModules and its allowlist, which replace the
webpack-node-externals plugin, plus the { external, sideEffects } value
form, both added in webpack 5.110.0. Also fills in the bun and deno
preset rows, which the table was missing.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…resourceHints.dedupe and per-entry html

Adds the [containedfile]/[containedpath] template placeholders,
output.library.umdAmdContainer and output.resourceHints.dedupe from
webpack 5.110.0, plus the entry descriptor's html option, which now
accepts an object overriding output.html per entry.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
webpack 5.110.0 makes optimization.minimize accept an object that
configures the built-in minimizer per asset type, and the default
minimizer now handles CSS and HTML too. Documents the javascript, css
and html option sets and when each minifier runs.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Also adds the deferImport and sourceImport environment flags to the
output.environment listing, both added in webpack 5.110.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
…ooks

The module variable reads back the CSS collected while rendering without
a DOM, and MultiCompiler gained an aggregated shutdown hook plus a done
hook that reports which compilers actually rebuilt. Both in 5.110.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Adds the renderEmbeddedSource and embeddedSourceHash compilation hooks,
and updates the HTML HMR note: 5.110.0 patches the head in place instead
of falling back to a full page reload.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 27, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
webpack-js-org Ready Ready Preview Aug 28, 2026 3:51am

Request Review

Resolves the overlap with #8339, which documented the same two options
independently:

- optimization.minimize: keeps main's version, and adds the three facts
  it was missing (the CSS/HTML minifiers only run with experiments.css /
  experiments.html and step aside for an already configured minimizer,
  the options configure the default minimizer only, and the javascript
  default is { compress: { passes: 2 } }).
- entry descriptor html: drops this branch's separate 'HTML per entry'
  section in favour of main's paragraph, noting there that the object
  form arrived in 5.110.0.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@bjohansebas
bjohansebas marked this pull request as ready for review August 28, 2026 03:32
The local prettier (3.8.3) reformatted two of main's inline block
comments onto their own lines; the declared version (3.9.6), which CI
installs, wants them inline, which is how they are committed on main.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@bjohansebas
bjohansebas merged commit 1a83fe2 into main Aug 28, 2026
11 checks passed
@bjohansebas
bjohansebas deleted the docs/webpack-5-110 branch August 28, 2026 04:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant