Change8

Migrating to Vitest v4.0.0-beta.9

Version v4.0.0-beta.9 introduces 1 breaking change. This guide details how to update your code.

Released: 8/26/2025

1
Breaking Changes
3
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

VitestConfig.minWorkersgetGlobalTestNamePatternlocator.elementvitest:coverage-transform pluginutils.astchai

Breaking Changes

Issue #1

Removed `minWorkers` configuration option; it is now automatically set to 0 in non‑watch mode. Update your Vitest config to omit `minWorkers` or rely on the default behavior.

Migration Steps

  1. 1
    Delete any `minWorkers` setting from your Vitest configuration; the runner will set it to 0 automatically when not in watch mode.
  2. 2
    If you imported `utils.ast`, replace it with an alternative AST utility or remove the import.
  3. 3
    Switch direct `chai` imports to `@vitest/expect` if you relied on the previous dependency.

Release Summary

Vitest v4.0.0‑beta.9 introduces the `getGlobalTestNamePattern` API, fixes several browser and coverage issues, and removes the `minWorkers` config, requiring a small migration step.

Need More Details?

View the full release notes and all changes for Vitest v4.0.0-beta.9.

View Full Changelog