fix(schema): turn off purgeCachedData until v4

danielroe · danielroe · commit 7aa3a01aeb65 · 2025-04-26T20:48:43.000+01:00
diff --git a/docs/2.guide/3.going-further/1.experimental-features.md b/docs/2.guide/3.going-further/1.experimental-features.md
@@ -591,13 +591,13 @@ const value = new SomeClass().someMethod()
 
 ## purgeCachedData
 
-Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`. This helps prevent memory leaks
-and ensures fresh data is loaded when needed, but it is possible to disable it:
+In the future, Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`. This helps prevent memory leaks
+and ensures fresh data is loaded when needed. You can enable it with:
 
 ```ts twoslash [nuxt.config.ts]
 export default defineNuxtConfig({
   experimental: {
-    purgeCachedData: false
+    purgeCachedData: true
   }
 })
 ```
diff --git a/packages/schema/src/config/experimental.ts b/packages/schema/src/config/experimental.ts
@@ -576,25 +576,25 @@ export default defineResolvers({
     /**
      * Whether to clean up Nuxt static and asyncData caches on route navigation.
      *
-     * Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`. This helps prevent memory leaks
-     * and ensures fresh data is loaded when needed, but it is possible to disable it.
+     * In the future, Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`.
+     * This will help prevent memory leaks and ensure fresh data is loaded when needed. You can enable it.
      *
      * @example
      * ```ts
      * // nuxt.config.ts
      * export default defineNuxtConfig({
      *   experimental: {
      *     // Disable automatic cache cleanup (default is true)
-     *     purgeCachedData: false
+     *     purgeCachedData: true
      *   }
      * })
      * ```
      *
      * @see [PR #31379](https://github.com/nuxt/nuxt/pull/31379)
      */
     purgeCachedData: {
-      $resolve: (val) => {
-        return typeof val === 'boolean' ? val : true
+      $resolve: async (val, get) => {
+        return typeof val === 'boolean' ? val : ((await get('future')).compatibilityVersion === 4)
       },
     },
 
diff --git a/packages/schema/src/types/schema.ts b/packages/schema/src/types/schema.ts
@@ -1559,17 +1559,16 @@ export interface ConfigSchema {
     /**
      * Whether to clean up Nuxt static and asyncData caches on route navigation.
      *
-     * Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`. This helps prevent memory leaks and ensures fresh data is loaded when needed, but it is possible to disable it.
-     *
-     * @default true
+     * In the future, Nuxt will automatically purge cached data from `useAsyncData` and `nuxtApp.static.data`.
+     * This will help prevent memory leaks and ensure fresh data is loaded when needed. You can enable it.
      *
      * @example
      * ```ts
      * // nuxt.config.ts
      * export default defineNuxtConfig({
      *   experimental: {
      *     // Disable automatic cache cleanup (default is true)
-     *     purgeCachedData: false
+     *     purgeCachedData: true
      *   }
      * })
      * ```
