Skip to content

feat: default experiments.css/html/asyncWebAssembly to "auto" - #21365

Merged
alexander-akait merged 2 commits into
mainfrom
feat/experiments-css-html-wasm-auto
Jul 8, 2026
Merged

alexander-akait merged 2 commits into
mainfrom
feat/experiments-css-html-wasm-auto

Conversation

@alexander-akait

Copy link
Copy Markdown
Member

Summary

The built-in CSS, HTML and async-WebAssembly module types currently require an explicit experiments opt-in. This defaults experiments.css, experiments.html and experiments.asyncWebAssembly to a new "auto" value that enables the built-in module type only when the user hasn't already registered a loader (or explicit type) for those files, so it stays non-breaking for existing css-loader/mini-css-extract-plugin/html-loader/wasm-loader setups. Detection lives on RuleSetCompiler.hasRuleForResource (reusing compileCondition): it walks module.rules (incl. oneOf/rules), treats include/exclude leniently, ignores enforce: "pre"|"post" loaders, and also counts a test regexp that references the extension so filename-scoped loaders are detected; asyncWebAssembly "auto" additionally defers to syncWebAssembly. Auto-enabled html/css stay below .js in the ESM resolve extensions (only an explicit opt-in keeps .html ahead of .js), and devtool is resolved after experiments so auto-enabled css still gets the default dev css source map.

What kind of change does this PR introduce?

feat

Did you add tests for your changes?

Yes — test/Defaults.unittest.js (auto-resolution matrix across css/html/wasm incl. sass/less, filename-scoped and enforce:pre loaders, resolve-extension priority, and the dev css source map) plus new test/configCases/css/{auto-default,auto-loader,auto-sass-like}; the wasm/html cases that assert the disabled path now opt out explicitly.

Does this PR introduce a breaking change?

Behavioral but guarded: the built-in css/html/async-wasm support now activates by default when no loader handles those files, so a .css/.html/.wasm import that previously errored now builds. Existing loader-based setups are detected and left untouched; opt out any time with experiments.{css,html,asyncWebAssembly}: false.

If relevant, what needs to be documented once your changes are merged or what have you already documented?

The experiments.{css,html,asyncWebAssembly} defaults and the new "auto" value should be documented in the experiments section on webpack.js.org.

Use of AI

AI (Claude) was used substantially to implement, test and verify this change — including writing the detection logic and tests, and validating no regressions by running the css-loader, mini-css-extract-plugin, html-loader and sass-loader suites plus an end-to-end wasm build against this branch.


Generated by Claude Code

Copilot AI review requested due to automatic review settings July 8, 2026 15:26
@changeset-bot

changeset-bot Bot commented Jul 8, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: f93ec13

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
webpack Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@github-actions

github-actions Bot commented Jul 8, 2026 •

Copy link
Copy Markdown
Contributor

This PR is packaged and the instant preview is available (a3773f5).

Install it locally:

  • npm
npm i -D webpack@https://pkg.pr.new/webpack@a3773f5
  • yarn
yarn add -D webpack@https://pkg.pr.new/webpack@a3773f5
  • pnpm
pnpm add -D webpack@https://pkg.pr.new/webpack@a3773f5

@codspeed

codspeed Bot commented Jul 8, 2026 •

Copy link
Copy Markdown

Merging this PR will not alter performance

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
❌ 3 regressed benchmarks
✅ 138 untouched benchmarks

Warning

Please fix the performance issues or acknowledge them on CodSpeed.

Performance Changes

Mode Benchmark BASE HEAD Efficiency
❌ Memory benchmark "react", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}' 159.5 KB 602.6 KB -73.52%
❌ Memory benchmark "cache-filesystem", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}' 1 MB 1.7 MB -41.39%
❌ Memory benchmark "json-modules", scenario '{"name":"mode-development","mode":"development"}' 509.9 KB 771.8 KB -33.93%
⚡ Memory benchmark "many-modules-esm", scenario '{"name":"mode-development","mode":"development"}' 1,197.6 KB 647.8 KB +84.88%
⚡ Memory benchmark "wasm-modules-async", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}' 330 KB 194.3 KB +69.81%
⚡ Memory benchmark "many-modules-commonjs", scenario '{"name":"mode-development","mode":"development"}' 1,220.2 KB 808.4 KB +50.93%

Tip

Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.


Comparing feat/experiments-css-html-wasm-auto (f93ec13) with main (20a9db3)

Open in CodSpeed

@codecov

codecov Bot commented Jul 8, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.82%. Comparing base (03fffac) to head (f93ec13).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #21365      +/-   ##
==========================================
+ Coverage   92.80%   92.82%   +0.02%     
==========================================
  Files         595      595              
  Lines       67133    67191      +58     
  Branches    18794    18831      +37     
==========================================
+ Hits        62301    62373      +72     
+ Misses       4832     4818      -14     
Flag Coverage Δ
css-parsing 26.66% <47.88%> (-1.67%) ⬇️
html5lib 28.26% <50.70%> (+0.19%) ⬆️
integration 88.96% <97.18%> (+0.02%) ⬆️
test262 42.68% <81.69%> (-3.22%) ⬇️
unit 44.46% <100.00%> (+0.17%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copilot AI review requested due to automatic review settings July 8, 2026 15:42
@alexander-akait
alexander-akait force-pushed the feat/experiments-css-html-wasm-auto branch from ea65b72 to 0d52286 Compare July 8, 2026 15:42

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@alexander-akait
alexander-akait force-pushed the feat/experiments-css-html-wasm-auto branch from 0d52286 to dce5e66 Compare July 8, 2026 15:53
Copilot AI review requested due to automatic review settings July 8, 2026 15:53

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@alexander-akait
alexander-akait force-pushed the feat/experiments-css-html-wasm-auto branch from dce5e66 to 6121120 Compare July 8, 2026 15:56
Copilot AI review requested due to automatic review settings July 8, 2026 15:56

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Default `experiments.css`, `experiments.html` and `experiments.asyncWebAssembly`
to `"auto"`, which enables the built-in module type unless the user already
registers a loader (or explicit type) for those files — so enabling them by
default does not break existing css-loader/html-loader/wasm-loader setups.

Detection lives on `RuleSetCompiler.hasRuleForResource` (reusing
`compileCondition`): it walks `module.rules` (including `oneOf`/`rules`), treats
`include`/`exclude` leniently, ignores `enforce: "pre"|"post"` loaders, and also
counts a `test` regexp that references the extension so filename-scoped loaders
are detected. `asyncWebAssembly` "auto" defers to `syncWebAssembly`.

Auto-enabled html/css stay below `.js` in the ESM resolve extensions (only an
explicit opt-in keeps `.html` ahead of `.js`), and `devtool` is resolved after
experiments so auto-enabled css still gets the default dev css source map.
@alexander-akait
alexander-akait force-pushed the feat/experiments-css-html-wasm-auto branch from 6121120 to 029c667 Compare July 8, 2026 16:04
Copilot AI review requested due to automatic review settings July 8, 2026 16:04

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Enabling `experiments.html` by default applies HtmlModulesPlugin to every
build. Its lazy `require`s inside the newCompilation hook crashed a watch
rebuild that raced after Jest teardown; hoisting them to module scope fixes
that and avoids re-requiring per compilation. Keep the no-loader Errors case
opted out of the html experiment so it still exercises that path.
Copilot AI review requested due to automatic review settings July 8, 2026 16:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Types Coverage

Coverage after merging feat/experiments-css-html-wasm-auto into main will be
99.37%
Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
bin
   webpack.js98.77%100%100%98.77%91
examples
   build-common.js100%100%100%100%
   buildAll.js100%100%100%100%
   examples.js100%100%100%100%
   template-common.js98.21%100%100%98.21%72
examples/custom-javascript-parser
   test.filter.js100%100%100%100%
examples/custom-javascript-parser/internals
   acorn-parse.js100%100%100%100%
   meriyah-parse.js100%100%100%100%
   oxc-parse.js91.30%100%100%91.30%140, 142–143, 145, 147, 153–154, 161, 168, 90
examples/markdown
   webpack.config.mjs100%100%100%100%
examples/module-federation
   test.filter.js100%100%100%100%
examples/reexport-components
   test.filter.js100%100%100%100%
examples/typescript
   test.filter.js100%100%100%100%
examples/typescript-non-erasable
   test.filter.js50%100%100%50%5
examples/virtual-modules
   test.filter.js100%100%100%100%
examples/wasm-bindgen-esm
   test.filter.js100%100%100%100%
examples/wasm-complex
   test.filter.js100%100%100%100%
examples/wasm-emscripten
   test.filter.js100%100%100%100%
examples/wasm-simple
   test.filter.js100%100%100%100%
examples/wasm-simple-source-phase
   test.filter.js100%100%100%100%
lib
   APIPlugin.js100%100%100%100%
   AsyncDependenciesBlock.js100%100%100%100%
   AutomaticPrefetchPlugin.js100%100%100%100%
   BannerPlugin.js100%100%100%100%
   Cache.js98.21%100%100%98.21%101
   CacheFacade.js100%100%100%100%
   Chunk.js99.72%100%100%99.72%39
   ChunkGraph.js100%100%100%100%
   ChunkGroup.js100%100%100%100%
   ChunkTemplate.js100%100%100%100%
   CircularModulesPlugin.js98.81%100%100%98.81%136
   CleanPlugin.js99.12%100%100%99.12%207, 227
   CodeGenerationResults.js100%100%100%100%
   CompatibilityPlugin.js100%100%100%100%
   Compilation.js98.44%100%100%98.44%1638, 1957, 1964, 1972, 1994, 1997, 2936, 3415–3416, 3448, 4148, 4178, 4231–4232, 4236, 4241, 4257–4258, 4272–4273, 4278–4279, 4756, 4782, 526, 531, 5590, 5622, 5639, 5655, 5671, 5686, 5711–5712, 5714, 6042, 6047, 6053, 6056, 6068, 6070, 6074, 6090, 6105, 6137, 6191, 6215, 6329, 777–778
   Compiler.js99.56%100%100%99.56%1147–1148, 1156
   ConcatenationScope.js98.65%100%100%98.65%195
   ConditionalInitFragment.js100%100%100%100%
   ConstPlugin.js100%100%100%100%
   ContextExclusionPlugin.js100%100%100%100%
   ContextModule.js100%100%100%100%
   ContextModuleFactory.js97.40%100%100%97.40%258, 395, 418, 420, 424, 433–434
   ContextReplacementPlugin.js100%100%100%100%
   DefinePlugin.js98.99%100%100%98.99%172–173, 189, 208, 282
   DependenciesBlock.js100%100%100%100%
   Dependency.js98.51%100%100%98.51%479, 525
   DependencyTemplate.js100%100%100%100%
   DependencyTemplates.js100%100%100%100%
   DotenvPlugin.js98.41%100%100%98.41%378, 391–392
   DynamicEntryPlugin.js100%100%100%100%
   EntryOptionPlugin.js100%100%100%100%
   EntryPlugin.js100%100%100%100%
   Entrypoint.js100%100%100%100%
   EnvironmentPlugin.js97.14%100%100%97.14%49
   ErrorHelpers.js100%100%100%100%
   EvalDevToolModulePlugin.js100%100%100%100%
   EvalSourceMapDevToolPlugin.js100%100%100%100%
   ExportsInfo.js100%100%100%100%
   ExportsInfoApiPlugin.js100%100%100%100%
   ExternalModule.js98.63%100%100%98.63%1176, 1179, 513–517, 519, 665
   ExternalModuleFactoryPlugin.js100%100%100%100%
   ExternalsPlugin.js100%100%100%100%
   FileSystemInfo.js99.52%100%100%99.52%182, 2382–2383, 2386, 2397, 2408, 2419, 280, 3823, 3838, 3862
   FlagAllModulesAsUsedPlugin.js100%100%100%100%
   FlagDependencyExportsPlugin.js98.21%100%100%98.21%448, 457, 460, 464, 476
   FlagDependencyUsagePlugin.js100%100%100%100%
   FlagEntryExportAsUsedPlugin.js100%100%100%100%
   Generator.js100%100%100%100%
   HotModuleReplacementPlugin.js100%100%100%100%
   HotUpdateChunk.js100%100%100%100%
   IgnorePlugin.js100%100%100%100%
   IgnoreWarningsPlugin.js100%100%100%100%
   InitFragment.js100%100%100%100%
   JavascriptMetaInfoPlugin.js100%100%100%100%
   LazyBarrel.js100%100%100%100%
   LibraryTemplatePlugin.js100%100%100%100%
   LoaderOptionsPlugin.js100%100%100%100%
   LoaderTargetPlugin.js100%100%100%100%
   MainTemplate.js100%100%100%100%
   ManifestPlugin.js100%100%100%100%
   Module.js98.50%100%100%98.50%1285, 1290, 1350, 1364, 1426, 1435
   ModuleFactory.js100%100%100%100%
   ModuleFilenameHelpers.js98.85%100%100%98.85%106, 108
   ModuleGraph.js99.73%100%100%99.73%1005
   ModuleGraphConnection.js100%100%100%100%
   ModuleInfoHeaderPlugin.js100%100%100%100%
   ModuleNotFoundError.js100%100%100%100%
   ModuleProfile.js100%100%100%100%
   ModuleSourceTypeConstants.js100%100%100%100%
   ModuleTemplate.js100%100%100%100%
   ModuleTypeConstants.js100%100%100%100%
   MultiCompiler.js99.69%100%100%99.69%661
   MultiStats.js100%100%100%100%
   MultiWatching.js100%100%100%100%
   NoEmitOnErrorsPlugin.js100%100%100%100%
   NodeStuffPlugin.js100%100%100%100%
   NormalModule.js97.89%100%100%97.89%1223, 1226, 1243, 1260, 1507, 1541, 1557, 1644, 2000, 2299, 2304–2314, 415, 419, 573
   NormalModuleFactory.js99.47%100%100%99.47%1083, 1392, 486, 498
   NormalModuleReplacementPlugin.js100%100%100%100%
   NullFactory.js100%100%100%100%
   OptimizationStages.js100%100%100%100%
   OptionsApply.js100%100%100%100%
   Parser.js100%100%100%100%
   PlatformPlugin.js100%100%100%100%
   PrefetchPlugin.js100%100%100%100%
   ProgressPlugin.js99.80%100%100%99.80%688
   ProvidePlugin.js100%100%100%100%
   RawModule.js100%100%100%100%
   RecordIdsPlugin.js100%100%100%100%
   RequestShortener.js100%100%100%100%
   ResolverFactory.js100%100%100%100%
   RuntimeGlobals.js100%100%100%100%
   RuntimeModule.js100%100%100%100%
   RuntimePlugin.js100%100%100%100%
   RuntimeTemplate.js100%100%100%100%
   SelfModuleFactory.js100%100%100%100%
   SingleEntryPlugin.js100%100%100%100%
   SourceMapDevToolModuleOptionsPlugin.js100%100%100%100%
   SourceMapDevToolPlugin.js98.62%100%100%98.62%220, 224, 226, 419, 430, 889
   Stats.js100%100%100%100%
   Template.js100%100%100%100%
   TemplatedPathPlugin.js99.43%100%100%99.43%308–309
   UseStrictPlugin.js100%100%100%100%
   WarnCaseSensitiveModulesPlugin.js100%100%100%100%
   WarnDeprecatedOptionPlugin.js100%100%100%100%
   WarnNoModeSetPlugin.js100%100%100%100%
   WatchIgnorePlugin.js100%100%100%100%
   Watching.js100%100%100%100%
   WebpackError.js100%100%100%100%
   WebpackIsIncludedPlugin.js100%100%100%100%
   WebpackOptionsApply.js100%100%100%100%
   WebpackOptionsDefaulter.js100%100%100%100%
   buildChunkGraph.js99.87%100%100%99.87%371
   cli.js98.63%100%100%98.63%10, 119, 549, 581, 631, 905
   index.js99.72%100%100%99.72%184
   validateSchema.js94.67%100%100%94.67%100, 87, 89, 98
   webpack.js97.10%100%100%97.10%10, 263, 285, 287
lib/asset
   AssetBytesGenerator.js100%100%100%100%
   AssetBytesParser.js100%100%100%100%
   AssetGenerator.js100%100%100%100%
   AssetModule.js100%100%100%100%
   AssetModulesPlugin.js97.33%100%100%97.33%282, 306, 309, 36, 362, 41
   AssetParser.js100%100%100%100%
   AssetSourceGenerator.js100%100%100%100%
   AssetSourceParser.js100%100%100%100%
   RawDataUrlModule.js100%100%100%100%
lib/async-modules
   AsyncModuleHelpers.js100%100%100%100%
   AwaitDependenciesInitFragment.js100%100%100%100%
   InferAsyncModulesPlugin.js100%100%100%100%
lib/bun
   BunTargetPlugin.js100%100%100%100%
lib/cache
   AddBuildDependenciesPlugin.js100%100%100%100%
   AddManagedPathsPlugin.js100%100%100%100%
   IdleFileCachePlugin.js97.92%100%100%97.92%75, 87, 95
   MemoryCachePlugin.js95.83%100%100%95.83%33
   MemoryWithGcCachePlugin.js93.15%100%100%93.15%107, 114–115, 123, 90
   PackFileCacheStrategy.js96.40%100%100%96.40%1251, 1351, 1355, 1417, 628, 647, 657–659, 661, 677–678, 683, 686, 688, 693, 698, 723, 729, 763, 769, 775, 780, 791, 800, 805–806, 808, 825, 831–832, 834
   ResolverCachePlugin.js100%100%100%100%
   getLazyHashedEtag.js100%100%100%100%
   mergeEtags.js100%100%100%100%
lib/config
   browserslistTargetHandler.js100%100%100%100%
   defaults.js99.34%100%100%99.34%1513–1515, 1523, 276, 279, 284,

@alexander-akait
alexander-akait merged commit a3773f5 into main Jul 8, 2026
63 checks passed
@alexander-akait
alexander-akait deleted the feat/experiments-css-html-wasm-auto branch July 8, 2026 20:22
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.

2 participants