fix: inherit fsModuleCachePath by default

sheremet-va · sheremet-va · commit ef1657ffab87 · 2025-11-20T11:45:20.000+01:00
diff --git a/docs/api/advanced/plugin.md b/docs/api/advanced/plugin.md
@@ -170,4 +170,4 @@ export function plugin(options: PluginOptions) {
 }
 ```
 
-If the `false` is returned, the module will not be cached on the file system.
+If `false` is returned, the module will not be cached on the file system.
diff --git a/docs/api/advanced/vitest.md b/docs/api/advanced/vitest.md
@@ -614,4 +614,4 @@ This method will [collect tests](#parsespecification) from an array of specifica
 function experimental_clearCache(): Promise<void>
 ```
 
-Deletes all Vitest caches, including [`experimental.fsModuleCache`](/config/experimental#fsmodulecache).
+Deletes all Vitest caches, including [`experimental.fsModuleCache`](/config/experimental#experimental-fsmodulecache).
diff --git a/packages/vitest/src/node/plugins/workspace.ts b/packages/vitest/src/node/plugins/workspace.ts
@@ -102,6 +102,10 @@ export function WorkspaceVitestPlugin(
           vitestConfig.experimental ??= {}
           vitestConfig.experimental.fsModuleCache = project.vitest.config.experimental.fsModuleCache
         }
+        if (testConfig.experimental?.fsModuleCachePath == null && project.vitest.config.experimental?.fsModuleCachePath !== null) {
+          vitestConfig.experimental ??= {}
+          vitestConfig.experimental.fsModuleCachePath = project.vitest.config.experimental.fsModuleCachePath
+        }
 
         return {
           base: '/',
diff --git a/test/config/test/override.test.ts b/test/config/test/override.test.ts
@@ -1,5 +1,6 @@
 import type { UserConfig as ViteUserConfig } from 'vite'
 import type { TestUserConfig } from 'vitest/node'
+import { resolve } from 'pathe'
 import { describe, expect, it, onTestFinished } from 'vitest'
 import { createVitest, parseCLI } from 'vitest/node'
 
@@ -94,6 +95,7 @@ it('experimental fsModuleCache is inherited in a project', async () => {
   const v = await vitest({}, {
     experimental: {
       fsModuleCache: true,
+      fsModuleCachePath: './node_modules/custom-cache-path',
     },
     projects: [
       {
@@ -105,24 +107,32 @@ it('experimental fsModuleCache is inherited in a project', async () => {
   })
   expect(v.config.experimental.fsModuleCache).toBe(true)
   expect(v.projects[0].config.experimental.fsModuleCache).toBe(true)
+
+  expect(v.config.experimental.fsModuleCachePath).toBe(resolve('./node_modules/custom-cache-path'))
+  expect(v.projects[0].config.experimental.fsModuleCachePath).toBe(resolve('./node_modules/custom-cache-path'))
 })
 
 it('project overrides experimental fsModuleCache', async () => {
   const v = await vitest({}, {
     experimental: {
       fsModuleCache: true,
+      fsModuleCachePath: './node_modules/custom-cache-path',
     },
     projects: [
       {
         test: {
           name: 'project',
           experimental: {
             fsModuleCache: false,
+            fsModuleCachePath: './node_modules/project-cache-path',
           },
         },
       },
     ],
   })
   expect(v.config.experimental.fsModuleCache).toBe(true)
   expect(v.projects[0].config.experimental.fsModuleCache).toBe(false)
+
+  expect(v.config.experimental.fsModuleCachePath).toBe(resolve('./node_modules/custom-cache-path'))
+  expect(v.projects[0].config.experimental.fsModuleCachePath).toBe(resolve('./node_modules/project-cache-path'))
 })

Original file line number	Diff line number	Diff line change
`@@ -170,4 +170,4 @@ export function plugin(options: PluginOptions) {`
`170`	`170`	`}`
`171`	`171`	```
`172`	`172`
`173`		-If the `false` is returned, the module will not be cached on the file system.
	`173`	+If `false` is returned, the module will not be cached on the file system.