Skip to content

fix(javascript): keep the comments of an empty statement the SyntaxTree printer drops - #22649

Merged
alexander-akait merged 1 commit into
mainfrom
fix/javascript-tree-print-empty-statement-comments
Oct 12, 2026
Merged

alexander-akait merged 1 commit into
mainfrom
fix/javascript-tree-print-empty-statement-comments

Conversation

@alexander-akait

@alexander-akait alexander-akait commented Oct 12, 2026 •

Copy link
Copy Markdown
Member

Summary

main fails syntax-printer › correct phase › should keep the comments of an empty statement it drops. #22628 taught the old printer to keep a dropped ;'s comments, and #22643 (tested on an older base) added the SyntaxTree printer without it. The tree printer now does the same.

minify(input, { compress: false, mangle: false, format: { comments: "all" } }):

// input
;// START_2;
console.log(2);
;// END_2;

// before
// START_2;
console.log(2);// START_3; …

// after (same as the old path)
// START_2;
console.log(2);// END_2;
// START_3; …

Code and source map match the old path byte for byte on 4 inputs × 3 comments settings.

What kind of change does this PR introduce?

fix

Did you add tests for your changes?

The existing test from #22628 covers it; it fails on main and passes here.

Does this PR introduce a breaking change?

No.

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

n/a

Use of AI

Claude Code found the failure, wrote the fix and compared it with the old path under the author's direction. The author reviewed the result.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Tgxgyb4N35ndP6cC4KcrXC


Generated by Claude Code

Summary by CodeRabbit

  • Bug Fixes
    • Leading comments are now preserved when printing empty statements.

@changeset-bot

changeset-bot Bot commented Oct 12, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 6598ae2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

@coderabbitai

coderabbitai Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: Repository: webpack/webpack/.coderabbit.yaml
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 2f6df1cd-6b9a-4af2-a943-a25e9e870dd2

📥 Commits

Reviewing files that changed from the base of the PR and between cf97e07 and 6598ae2.


📒 Files selected for processing (1)
  • lib/javascript/syntax-printer.js

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 0 remain after this review.



📝 Walkthrough

Walkthrough

The tree printer now prepends comments when it encounters an empty statement.

Changes

Empty statement comment handling

Layer / File(s) Summary
Prepend empty statement comments
lib/javascript/syntax-printer.js
The tree printer prepends comments to the output for empty statements.

Suggested labels: area: parser, needs: tests

Suggested reviewers: aryanraj45


Priority: ⬇️ Low

Change: Bug fix

Merge Risk: ⚪ Minimal · up to 6598a

The printer now preserves retained comments when dropping empty statements. No actionable merge-blocking risk is established for this change.

Pre-merge checks | Passed 3 | Inconclusive 1

❌ Failed checks (1 inconclusive)

Check name Status Explanation Resolution
Title check Inconclusive The title follows the required Conventional Commit form: fix(javascript): subject. The branch prefix is not provided, so the required type match cannot be verified. Provide the branch name or confirm that its prefix is fix.
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Warning

Some tools did not complete. Review the errors below.

🔧 ast-grep (0.45.3)
lib/javascript/syntax-printer.js

ast-grep timed out on this file


🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

lib/javascript/syntax-printer.js

ESLint failed to execute (timeout).



Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot added area: parser JavaScript parsing and dependency analysis (lib/javascript, lib/dependencies) needs: tests Fix or PR exists but lacks the required tests labels Oct 12, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Types Coverage

Coverage after merging fix/javascript-tree-print-empty-statement-comments into main will be
97.29%
Coverage Report
FileStmtsBranchesFuncsLinesUncovered Lines
bin
   webpack.js98.82%100%100%98.82%103
declarations
   WebpackOptions.ts99.94%100%100%99.94%4193
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.js100%100%100%100%
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/ssr
   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
   Chunk.js100%100%100%100%
   Compilation.js98.60%100%100%98.60%1757, 2078, 2085, 2093, 2115, 2118, 23, 3075, 3578–3579, 3611, 4200, 4204, 4331, 4352, 4477, 4514, 4521, 4574–4575, 4579, 4584, 4600–4601, 4615–4616, 4621–4622, 5145, 5171, 6001, 6018, 6036, 6052, 6067, 6092, 6095, 6463, 6466–6467, 6472, 6487, 6570, 6594, 6708, 837–838
   Compiler.js98.81%100%100%98.81%1116, 1153, 1156, 1336–1337, 1345, 848, 934, 975
   Dependency.js100%100%100%100%
   DependencyTemplate.js100%100%100%100%
   EntryPlugin.js100%100%100%100%
   Entrypoint.js100%100%100%100%
   ExternalsPlugin.js100%100%100%100%
   FileSystemInfo.js100%100%100%100%
   InitFragment.js100%100%100%100%
   LibraryTemplatePlugin.js100%100%100%100%
   ModuleFilenameHelpers.js100%100%100%100%
   ModuleNotFoundError.js100%100%100%100%
   MultiCompiler.js98.88%100%100%98.88%460, 532, 719, 784
   NormalModule.js100%100%100%100%
   NullFactory.js100%100%100%100%
   ProgressPlugin.js100%100%100%100%
   RawModule.js100%100%100%100%
   RequestShortener.js100%100%100%100%
   SingleEntryPlugin.js100%100%100%100%
   WebpackError.js100%100%100%100%
   index.js99.78%100%100%99.78%206
   webpack.js97.84%100%100%97.84%278, 300, 302
lib/asset
   AssetBytesGenerator.js100%100%100%100%
   AssetBytesParser.js100%100%100%100%
   AssetGenerator.js100%100%100%100%
   AssetModule.js100%100%100%100%
   AssetModulesPlugin.js98.14%100%100%98.14%337, 361, 364, 494, 56, 61
   AssetParser.js100%100%100%100%
   AssetSourceGenerator.js100%100%100%100%
   AssetSourceParser.js100%100%100%100%
   RawDataUrlModule.js100%100%100%100%
   WebManifestGenerator.js100%100%100%100%
   WebManifestParser.js100%100%100%100%
lib/async-modules
   AsyncModuleHelpers.js100%100%100%100%
   AwaitDependenciesInitFragment.js100%100%100%100%
   InferAsyncModulesPlugin.js100%100%100%100%
   isGeneratorLowered.js100%100%100%100%
lib/bun
   BunTargetPlugin.js100%100%100%100%
lib/cache
   AddBuildDependenciesPlugin.js100%100%100%100%
   AddManagedPathsPlugin.js100%100%100%100%
   Cache.js96.49%100%100%96.49%10, 104
   CacheFacade.js100%100%100%100%
   IdleFileCachePlugin.js97.92%100%100%97.92%75, 87, 95
   MemoryCachePlugin.js92%100%100%92%33, 42
   MemoryWithGcCachePlugin.js93.42%100%100%93.42%106, 120–121, 130, 88
   PackFileCacheStrategy.js96.54%100%100%96.54%1304, 1404, 1408, 1470, 1716, 1800, 1823, 1853, 682, 701, 711–713, 715, 731–732, 737, 740, 742, 747, 752, 777, 783, 817, 823, 829, 834, 845, 854, 859–860, 862, 879, 885–886, 888
   ResolverCachePlugin.js100%100%100%100%
   getLazyHashedEtag.js100%100%100%100%
   mergeEtags.js100%100%100%100%
lib/config
   OptionsApply.js100%100%100%100%
   PlatformPlugin.js100%100%100%100%
   WebpackOptionsApply.js100%100%100%100%
   WebpackOptionsDefaulter.js100%100%100%100%
   browserslistTargetHandler.js100%100%100%100%
   cli.js98.61%100%100%98.61%116, 546, 578, 628, 9
   defaults.js99.44%100%100%99.44%1624–1626, 1634, 283, 286, 291, 295
   defineConfig.js100%100%100%100%
   getClaimedAssetTypes.js100%100%100%100%
   normalization.js99.12%100%100%99.12%279–280, 346, 361
   target.js100%100%100%100%
   validateSchema.js94.67%100%100%94.67%100, 87, 89, 98
lib/container
   ContainerEntryDependency.js100%100%100%100%
   ContainerEntryModule.js100%100%100%100%
   ContainerEntryModuleFactory.js100%100%100%100%
   ContainerExposedDependency.js100%100%100%100%
   ContainerPlugin.js100%100%100%100%
   ContainerReferencePlugin.js100%100%100%100%
   FallbackDependency.js100%100%100%100%
   FallbackItemDependency.js100%100%100%100%
   FallbackModule.js100%100%100%100%
   FallbackModuleFactory.js100%100%100%100%
   HoistContainerReferencesPlugin.js100%100%100%100%
   ModuleFederationPlugin.js100%100%100%100%
   RemoteModule.js100%100%100%100%
   RemoteRuntimeModule.js100%100%100%100%
   RemoteToExternalDependency.js100%100%100%100%
   declaredRemotes.js100%100%100%100%
   moduleFederationHooks.js100%100%100%100%
   options.js100%100%100%100%
lib/context
   ContextExclusionPlugin.js100%100%100%100%
   ContextModule.js99.88%100%100%99.88%1495
   ContextModuleFactory.js95.70%100%100%95.70%230, 257, 276, 280–281, 289, 466, 487, 492, 534, 543, 545, 549, 552, 558–559
   ContextReplacementPlugin.js100%100%100%100%
lib/css
   CssGenerator.js99.29%100%100%99.29%1092, 134, 301, 849
   CssInjectStyleRuntimeModule.js100%100%100%100%
   CssLoadingRuntimeModule.js100%100%100%100%
   CssModule.js83.33%100%100%83.33%197, 202–210, 212–217
   CssModulesPlugin.js99.86%100%100%99.86%884
   CssParser.js99.48%100%100%99.48%1044, 1075, 24, 2406, 3053, 3056, 3062, 3103, 3106, 3145, 3148, 3485, 5039, 5042, 928
   CssServerStylesRuntimeModule.js100%100%100%100%
   conventions.js98.65%100%100%98.65%93
   cssMinify.js97.56%100%100%97.56%164, 173
   data.js99.84%100%100%99.84%229, 5601
   syntax-parser.js99.65%100%100%99.65%10272–10273, 10809–10810, 10847, 11042, 11088, 13420–13423, 13523–13524, 13621–13622, 14267, 14564, 14566, 15075, 15441, 17557, 2574, 3279, 3281, 3286, 3305, 4054, 4060, 7536, 7574, 7581
   syntax-printer.js99.31%100%100%99.31%2539–2540, 2542–2543, 2545–2546, 2551, 2818–2821, 2914, 351, 3589, 4009, 4118, 4806, 5107, 5894, 725
   syntax.js100%100%100%100%
   topologicalSort.js100%100%100%100%
lib/debug
   ProfilingPlugin.js96.22%100%100%96.22%169, 425, 554, 561, 570, 574, 583, 588, 594, 599, 92
lib/define
   DefinePlugin.js98.85%100%100%98.85%1495, 268–269, 285, 304, 378, 936, 938, 943, 967
   DotenvPlugin.js98.07%100%100%98.07%391, 439, 452–453
   EnvironmentPlugin.js97.14%100%100%97.14%49
lib/deno
   DenoTargetPlugin.js100%100%100%100%
lib/dependencies
   ConstDependency.js100%100%100%100%
   ContextElementDependency.js100%100%100%100%
   NullDependency.js100%100%100%100%
lib/dependencies/amd
   AMDDefineDependency.js100%100%100%100%
   AMDDefineDependencyParserPlugin.js100%100%100%100%
   AMDPlugin.js99.31%100%100%99.31%54
   AMDRequireArrayDependency.js100%100%100%100%
   AMDRequireContextDependency.js100%100%100%100%
   AMDRequireDependenciesBlock.js100%100%100%100%
   

@github-actions

github-actions Bot commented Oct 12, 2026 •

Copy link
Copy Markdown
Contributor

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

Install it locally:

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

alexander-akait added a commit that referenced this pull request Oct 12, 2026
…ee printer drops

Ported from #22649 so this branch's unit job passes on the current main.
@codecov

codecov Bot commented Oct 12, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.31%. Comparing base (b76f39a) to head (6598ae2).
⚠️ Report is 3 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main   #22649      +/-   ##
==========================================
+ Coverage   96.28%   96.31%   +0.03%     
==========================================
  Files         774      774              
  Lines      130216   131988    +1772     
  Branches    43417    44090     +673     
==========================================
+ Hits       125376   127126    +1750     
- Misses       4840     4862      +22     
Flag Coverage Δ
css-parsing 25.05% <ø> (-0.02%) ⬇️
html5lib 26.96% <ø> (-0.03%) ⬇️
integration 82.15% <ø> (-0.04%) ⬇️
minify-corpora 91.19% <100.00%> (+0.59%) ⬆️
syntax-equivalence 79.15% <ø> (ø)
test262 56.07% <0.00%> (-0.89%) ⬇️
test262-parser 82.17% <ø> (-0.49%) ⬇️
unit 75.93% <100.00%> (+0.25%) ⬆️

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.

@github-actions

Copy link
Copy Markdown
Contributor

Generated code size

Comparing base (cf97e07) to head (6598ae2). Merging this pull request will not change the code webpack generates.

What moved Tests Assets Gzip Raw Test edit
Changed, test untouched 0 0 — — —
Changed, test edited 0 0 — — —
New 0 0 — — —
Deleted 0 0 — — —
Unchanged — 8611 — — —

Read Changed, test untouched first: the test is byte-identical on both sides, so webpack generated the difference. Changed, test edited moved partly because the test did — Test edit is how many bytes the test gained, and a bundle that grew by less is not a regression. New and Deleted are whole files, not deltas — a new asset was created, not grown, so it reads gray (⚪ added) — and adding tests cannot bury a real change. Gzip decides, because that is what users download; raw is the tiebreak, and brotli and zstd are per asset below.

No asset changed size.

No runtime gained or lost a runtime module.

Built test/configCases with the defaults a user gets: 2219 test(s), 8611 asset(s), 99 emitted nothing.

@codspeed

codspeed Bot commented Oct 12, 2026

Copy link
Copy Markdown

Merging this PR will improve performance by ×2.5

⚠️ 108 benchmarks spent significant time in system calls

System calls cannot be consistently instrumented, so they are not included in the measure, which understates the real cost. Please switch to the Walltime instrument to accurately measure system calls.

Measurement and system calls

ℹ️ 28 benchmarks have no flame graph

The flamegraph could not be generated because too much time was spent in runtime internals, making the visualization not useful for performance analysis.

⚠️ 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

⚡ 2 improved benchmarks
✅ 404 untouched benchmarks
⏩ 6 skipped benchmarks1

Performance Changes

Mode Benchmark BASE HEAD Efficiency
⚡ Memory benchmark "html-many-chunks", scenario '{"name":"mode-development-rebuild","mode":"development","watch":true}' 536.1 KB 151.7 KB ×3.5
⚡ Memory unit benchmark "js-parser-unit", sourceType 'auto' 1,147.1 KB 643.9 KB +78.15%

Tip

Curious why performance improved? Comment @codspeedbot explain why performance improved on this PR, or directly use the CodSpeed MCP with your agent.


Comparing fix/javascript-tree-print-empty-statement-comments (6598ae2) with main (cf97e07)

Open in CodSpeed

Footnotes

  1. 6 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

alexander-akait added a commit that referenced this pull request Oct 12, 2026
…eal types (#22642)

* refactor(types): replace EXPECTED_OBJECT and EXPECTED_FUNCTION with real types

Type loader functions, HMR module factories and self-accept handlers, guard frames, syntax-printer walker callbacks, source maps and parse options, and the CSS/HTML print options instead of object/Function.

* refactor(types): use real types instead of unknown and Record<string, unknown>

Type the minimizer options, transform switches, profiler parameters, CLI configuration values, HMR handlers and the deprecated externals function precisely.

* refactor(types): let transform callbacks return a splice or the skip marker

* refactor(types): let transform callbacks return null

* refactor(types): type the self-accept error as unknown, as catch reads it

* refactor(types): type parseTree's options as terser's parse options

* fix(javascript): keep the comments of an empty statement the SyntaxTree printer drops

Ported from #22649 so this branch's unit job passes on the current main.
alexander-akait added a commit that referenced this pull request Oct 12, 2026
…e minifier's source map (#22654)

* fix(javascript): leave the enclose wrapper's unnamed source out of the minifier's source map

terser adds a null entry to sources for the wrapper enclose parses from no
file, which no mapping references and which Rollup rejects (terser#1333).

* fix(javascript): keep the comments of an empty statement the SyntaxTree printer drops

Same change as #22649, which main needs for the syntax-printer suite to pass.
@alexander-akait
alexander-akait merged commit 703b88d into main Oct 12, 2026
68 checks passed
@alexander-akait
alexander-akait deleted the fix/javascript-tree-print-empty-statement-comments branch October 12, 2026 20:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: parser JavaScript parsing and dependency analysis (lib/javascript, lib/dependencies) needs: tests Fix or PR exists but lacks the required tests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant