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 4.0.11 {#clearcache}
+## clearCache 5.0.0 {#clearcache}
```ts
-function experimental_clearCache(): Promise
+function clearCache(): Promise
```
Deletes all Vitest caches, including [`fsModuleCache`](/config/fsmodulecache).
+This was available since Vitest 4.0.11 as experimental `experimental_clearCache` method.
+
## experimental_getSourceModuleDiagnostic 4.0.15 {#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 {
+ 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 {
+ public async clearCache(): Promise {
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()
},
},
],