Skip to content

docs: resolve.fileSystem is honored since webpack 5.111.0 - #8402

Merged
alexander-akait merged 1 commit into
mainfrom
docs/resolve-file-system-honored
Sep 13, 2026
Merged

alexander-akait merged 1 commit into
mainfrom
docs/resolve-file-system-honored

Conversation

@alexander-akait

Copy link
Copy Markdown
Member

Summary

webpack/webpack#22091 has landed, so webpack no longer assigns the compiler's input filesystem over a configured resolve.fileSystem. The page currently warns that setting the option has no effect, which was accurate up to 5.110.x and is wrong from 5.111.0 on. Documents the option as it now behaves, keeps the old workaround as a version note for anyone on an earlier release, and adds the boundary the option does not cross: resolution reads through it, module source still reads through the compiler's inputFileSystem. Also updates resolve.resolver, which told readers a whole resolver was the only way to reach a different filesystem from the configuration.

Verified against the merged main (00c73f0a): with a counting filesystem in the config, resolution made 32 calls through resolve.fileSystem and 23 through resolveLoader.fileSystem, and a second probe showed the resolver reading package.json through the configured filesystem while src/index.js was read through the compiler's. 5.111.0 is the version 18 pending minor changesets put on top of 5.110.3.

What kind of change does this PR introduce?

docs

Did you add tests for your changes?

n/a — documentation only; the behavior it describes is covered by test/configCases/resolve/custom-file-system in webpack/webpack#22091.

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 — this PR is the documentation follow-up for webpack/webpack#22091.

Use of AI

AI was used. Claude Code ran the probes quoted above against the merged webpack main to confirm what the option now does and where it stops, and drafted the replacement text; I reviewed and edited it before pushing.


Generated by Claude Code

webpack/webpack#22091 stopped webpack from assigning the compiler's input
filesystem over a configured resolve.fileSystem, so the page's warning that
setting it has no effect is true only up to 5.110.x. Documents the option as it
now behaves, keeps the older workaround as a version note, and says what still
goes through the compiler's inputFileSystem.
@vercel

vercel Bot commented Sep 13, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
webpack-js-org Ready Ready Preview Sep 13, 2026 3:48pm UTC

Request Review

@alexander-akait
alexander-akait merged commit ebcec76 into main Sep 13, 2026
12 checks passed
@alexander-akait
alexander-akait deleted the docs/resolve-file-system-honored branch September 13, 2026 16:14

This branch was successfully deployed

1 active deployment
Preview — 65908b74 Deployed Sep 13, 2026 by vercel[bot]
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