From d4fe1986fe334d22940039e815ccdbcc907baa6a Mon Sep 17 00:00:00 2001
From: Vladimir <sleuths.slews0s@icloud.com>
Date: Sat, 29 Aug 2026 18:43:32 +0200
Subject: [PATCH] feat: promote clearCache out of experimental (#11086)

---
 docs/api/advanced/vitest.md             |  8 ++++----
 packages/vitest/src/node/cli/cli-api.ts |  2 +-
 packages/vitest/src/node/core.ts        | 11 +++++++++--
 test/e2e/test/caching.test.ts           |  6 +++---
 4 files changed, 17 insertions(+), 10 deletions(-)

diff --git a/docs/api/advanced/vitest.md b/docs/api/advanced/vitest.md
index e2d5f11d2..6a5d2bb31 100644
--- a/docs/api/advanced/vitest.md
+++ b/docs/api/advanced/vitest.md
@@ -597,16 +597,16 @@ function parseSpecifications(
 
 This method will [collect tests](#parsespecification) from an array of specifications. By default, Vitest will run only `os.availableParallelism()` number of specifications at a time to reduce the potential performance degradation. You can specify a different number in a second argument.
 
-This was available since Vitest 4.0.0 as experimental `experimental_parseSpecifications` method.
-
-## experimental_clearCache <Version type="experimental">4.0.11</Version> <Experimental /> {#clearcache}
+## clearCache <Version>5.0.0</Version> {#clearcache}
 
 ```ts
-function experimental_clearCache(): Promise<void>
+function clearCache(): Promise<void>
 ```
 
 Deletes all Vitest caches, including [`fsModuleCache`](/config/fsmodulecache).
 
+This was available since Vitest 4.0.11 as experimental `experimental_clearCache` method.
+
 ## experimental_getSourceModuleDiagnostic <Version type="experimental">4.0.15</Version> <Experimental /> {#getsourcemodulediagnostic}
 
 ```ts
diff --git a/packages/vitest/src/node/cli/cli-api.ts b/packages/vitest/src/node/cli/cli-api.ts
index 026cf99a5..b8ca7334a 100644
--- a/packages/vitest/src/node/cli/cli-api.ts
+++ b/packages/vitest/src/node/cli/cli-api.ts
@@ -151,7 +151,7 @@ export async function startVitest(
       await ctx.listTags()
     }
     else if (ctx.config.clearCache) {
-      await ctx.experimental_clearCache()
+      await ctx.clearCache()
     }
     else if (ctx.config.mergeReports) {
       await ctx.mergeReports()
diff --git a/packages/vitest/src/node/core.ts b/packages/vitest/src/node/core.ts
index 3b7fea5b3..a7ae46fec 100644
--- a/packages/vitest/src/node/core.ts
+++ b/packages/vitest/src/node/core.ts
@@ -669,11 +669,18 @@ export class Vitest {
     return this._coverageProvider
   }
 
+  /**
+   * @deprecated Use `clearCache` instead.
+   */
+  public experimental_clearCache(): Promise<void> {
+    this.logger.deprecate(`The "experimental_clearCache" method is deprecated. Use "clearCache" instead.`)
+    return this.clearCache()
+  }
+
   /**
    * Deletes all Vitest caches, including the `fsModuleCache`.
-   * @experimental
    */
-  public async experimental_clearCache(): Promise<void> {
+  public async clearCache(): Promise<void> {
     await this.cache.results.clearCache()
     await this._fsCache.clearCache()
   }
diff --git a/test/e2e/test/caching.test.ts b/test/e2e/test/caching.test.ts
index 7b658d462..78f7c1339 100644
--- a/test/e2e/test/caching.test.ts
+++ b/test/e2e/test/caching.test.ts
@@ -60,7 +60,7 @@ test('if no cache key generator is defined, the hash is invalid', async () => {
       {
         async onInit(vitest) {
           // make sure cache is empty
-          await vitest.experimental_clearCache()
+          await vitest.clearCache()
         },
       },
     ],
@@ -106,7 +106,7 @@ test('if cache key generator is defined, the hash is valid', async () => {
       {
         async onInit(vitest) {
           // make sure cache is empty
-          await vitest.experimental_clearCache()
+          await vitest.clearCache()
         },
       },
     ],
@@ -150,7 +150,7 @@ test('if cache key generator bails out, the file is not cached', async () => {
       {
         async onInit(vitest) {
           // make sure cache is empty
-          await vitest.experimental_clearCache()
+          await vitest.clearCache()
         },
       },
     ],
-- 
2.51.2