vitest: 4.1.11 → 5.0.0 · Semverse

vitest

Next generation testing framework powered by Vite

Latest 5.0.3486 published versionsvitest-dev/vitest

Choose your update

Your version

Target version

Include prereleases

Published Node.js and peer-dependency requirements.

Requirement	From4.1.11 on npm (opens in a new tab)	To5.0.0 on npm (opens in a new tab)
Node.js	`^20.0.0 \|\| ^22.0.0 \|\| >=24.0.0`	`^22.12.0 \|\| ^24.0.0 \|\| >=26.0.0`
@types/node	`^20.0.0 \|\| ^22.0.0 \|\| >=24.0.0`Optional peer · not required	`^22.0.0 \|\| >=24.0.0`Optional peer · not required
@vitest/browser-playwright	`4.1.11`Optional peer · not required	`5.0.0`Optional peer · not required
@vitest/browser-preview

1 release to review

Last checked 4 Oct 2026, 14:53 UTC

5.0.0

Breaking changes3 Sept 2026GitHub Release

Signals highlight changes worth reviewing. They cannot determine whether your application is affected.

4.1.11

@vitest/browser-webdriverio	`4.1.11`Optional peer · not required	`^5.0.0-beta.5 \|\| >=5.0.0`Optional peer · not required

@vitest/coverage-istanbul	`4.1.11`Optional peer · not required	`5.0.0`Optional peer · not required

@vitest/coverage-v8	`4.1.11`Optional peer · not required	`5.0.0`Optional peer · not required

@vitest/ui	`4.1.11`Optional peer · not required	`5.0.0`Optional peer · not required

vite	`^6.0.0 \|\| ^7.0.0 \|\| ^8.0.0`Required peer	`^6.4.0 \|\| ^7.0.0 \|\| ^8.0.0`Required peer

Vitest 5 is officially out! This release focuses on performance and brings a lot of new features while fixing long-standing bugs. See our blog post for the official announcement.

🚨 Breaking Changes

Replace loupe.inspect with pretty-format - by @hi-ogawa, Claude Opus 5 (1M context) and OpenAI Codex in #9609 (3f802)
Remove quotes from string values in test.for/each title $ variable (take 2) - by @hi-ogawa in #10170 (04d37)
Default attachmentsDir from .vitest-attachements/ to .vitest/attachments/ - by @MdSadiqMd in #10186 (1ba73)
Remove sequential test/suite options in favor of concurrent - by @hi-ogawa and OpenAI Codex in #10198 (9229f)
Represent locator as an object instead of a string - by @sheremet-va in #10212 (80f07)
Inline expect package - by @sheremet-va in #10221 (ad162)
Remove deprecated entry points - by @sheremet-va in #10222 (994c6)
Require Node.js 22 and Vite 6.4 - by @sheremet-va in #10178 (38762)
Fail expect.poll when function didn't resolve in time - by @hi-ogawa and OpenAI Codex in #10233 (4df04)
Throw an error if hoistable methods are outside the top level scope - by @sheremet-va in #10460 (d0b4f)
toHaveTextContent is strict, add toMatchTextContent as alternative - by @sheremet-va in #10473 (18f30)
Don't lookup config file from ancestor directories - by @hi-ogawa, OpenAI Codex and Hiroshi Ogawa in #10428 (945d9)
Inline @vitest/runner package, do not publish it anymore - by @sheremet-va in #10511 (6d6e4)
Allow mutating happy-dom/jsdom window object - by @hi-ogawa, Hiroshi Ogawa and OpenAI Codex in #10373 (206e8)
Expose concurrencyId/workerId on TestModule's diagnostics, make id 1-based - by @sheremet-va in #10516 (bdd98)
Add screenshotDirectory config to browser.expect.toMatchScreenshot - by @macarie in #10592 (a60de)
Update @sinonjs/fake-timers and support mocking Temporal - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10654 (f8b15)
Remove webdriverio package - by @sheremet-va in #10675 (5fed6)
Clear mocks by default before each test - by @sheremet-va in #10613 (0f646)
Don't emit localStorage warnings on Node 26, fail gracefully when worker fails to start - by @sheremet-va in #10293 (334ed)
Separate config resolution from the server creation - by @sheremet-va in #10554 (1c0ec)
Inline projects extend the root config by default - by @sheremet-va in #10750 (fec00)
Enable mocking Temporal without fake timers - by @fabon-f, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10757 (ac2d4)
Support nested projects - by @sheremet-va in #10846 (ec367)
Use > as separator in -t, calculate only once - by @sheremet-va in #10686 (a0b20)
Fail the test when an asynchronous assertion is not awaited - by @sheremet-va in #10868 (86d4a)
Share the Vite server between inline projects - by @sheremet-va in #10848 (d87c9)
Parse files statically in vitest list by default - by @sheremet-va in #11088 (51e94)
benchmark:
- Rewrite the public API - by @sheremet-va in #10113 (19f6e)
browser:
- Iframe scale - by @macarie in #9745 (b6398)
- Enable locators.exact by default - by @sheremet-va in #10430 (e2032)
- Require sessionId for orchestrator html request - by @hi-ogawa, Hiroshi Ogawa and OpenAI Codex in #10522 (79b7d)
- Save failure screenshots in attachmentsDir - by @macarie in #10917 (3b5bb)
coverage:
- include/exclude globs too eager - by @AriPerkkio in #9818 (edacb)
- Allow thresholds.perFile to accept an object - by @vladlenskiy and @AriPerkkio in #10190 (13b78)
expect:
- Fix toThrow("") behavior by reverting #6710 - by @hi-ogawa in #9643 and #6710 (6c3e4)
mocker:
- Deserialize automock as automock - by @nami8824 in #10192 (2f892)
reporters:
- blob reporter and --merge-reports default to .vitest/blob/ - by @AriPerkkio in #10232 (d22b0)
- Write json and junit reporter output files to .vitest by default - by @hi-ogawa, Hiroshi Ogawa, OpenCode (gpt-5.6-sol) and @AriPerkkio in #10621 (58577)
spy:
- Preserve class mock prototype methods on instances - by @sheremet-va in #10910 (6093d)
types:
- Add better promise support in expects and matchers - by @samchungy and @sheremet-va in #8266 (41f55)
ui:
- Harden UI API access - by @hi-ogawa, Hiroshi Ogawa and OpenAI Codex in #10583 (4c26d)
- Change html reporter default output to .vitest - by @hi-ogawa and Hiroshi Ogawa in #10620 (29c36)

🚀 Features

Add createReport and .vitest report directory convention - by @AriPerkkio in #9993 (72a6d)
Expose default reporters through configDefaults.reporters - by @hi-ogawa and Claude Opus 5 (1M context) in #10219 (083f6)
Support merge reports for non-sharded multi-environment runs (take 2) - by @hi-ogawa, Claude Opus 5 (1M context), OpenAI Codex and @AriPerkkio in #10031 (e60b2)
Add logger.formatError - by @hi-ogawa and OpenAI Codex in #10268 (2c5f3)
Support typescript build mode - by @lishaduck in #9870 (106da)
Add toggable injectCjsGlobals option - by @sheremet-va in #10709 (82671)
Promote fsModuleCache to a top-level option - by @sheremet-va in #10734 (78ed7)
Support non-ascii characters in for/each title placeholders - by @k-yle in #10773 (15e0a)
Report the duration breakdown as percentages - by @sheremet-va and @AriPerkkio in #10820 (c67d2)

🐞 Bug Fixes

Global sequence.concurrent: true with top-level test(..., { concurrent: false }) + depreacte sequential test API and options - by @hi-ogawa, OpenAI Codex and @sheremet-va in #10194 (9387f)
Test tags options should overwrite inherited suite options + inherit suite options in task API - by @hi-ogawa and OpenAI Codex in #10216 (457db)
Udpate optimize deps config - by @sheremet-va in #10223 (95dc6)
Shell injection safety via github.ref_name in publish workflow - by @lloyd-c137 and lloyd-c137 in #10327 (dd020)
Make attachmentsDir root only config - by @hi-ogawa and OpenAI Codex in #10334 (fab1b)
Apply cjs interop for truthy __esModule - by @hi-ogawa in #10363 (2b135)
Preserve vi.defineHelper callsite for async error stack - by @macayu17 and @hi-ogawa in #10415 (ac697)
Respect disableConsoleIntercept in browser mode - by @Copilot, Hiroshi Ogawa, @hi-ogawa and OpenAI Codex in #10391 (66110)
ForceRerunTriggers uses directory globs against files - by @Patrick-Clausen and in and

🏎 Performance

Stringify diff objects only once - by @sheremet-va in #10276 (d006a)
Improve performance in hot paths - by @sheremet-va in #10446 (03faf)
Serve warm modules to workers in one round-trip, enable the node compile cache - by @sheremet-va in #10708 (b144a)
Make the Node compile cache opt-in, persist worker caches on teardown - by @sheremet-va in #10742 (941bc)
Reuse compiled code across vm pool contexts and prewarm the module graph - by @sheremet-va in #10744 (d8b04)
Bundle vitest's own dependencies - by @sheremet-va in #10685 (c0508)
Lowers peak memory usage when using --changed on a large graph - by @jszumski in #10866 (9f23f)
Initialize trace view in the orchestrator once per worker - by @sheremet-va in #10984 (fad26)
browser:
- Reduce matching screenshot overhead - by @kasperpeulen in #10278 (511c0)
- Open browser sessions adaptively instead of maxWorkers upfront - by @sheremet-va in #10726

View changes on GitHub

browser:

Fix trace highlight of shadow dom on webdriverio - by @hi-ogawa in #10227 (b01af)
Simplify orchestrator otel carrier - by @hi-ogawa in #10283 (3514f)
Remove orphaned Playwright route when same module is mocked via multiple ids - by @Zelys-DFKH in #9957 and #10267 (41db6)
Skip wrapDynamicImport transform on ssr environment - by @hi-ogawa in #10355 (d3c96)
Fix stale source map on watch mode - by @hi-ogawa in #10389 (6d772)
Escape inline orchestrator scripts - by @hi-ogawa and OpenAI Codex in #10412 (c22cf)
Disable client cdp API when allowWrite/allowExec: false - by @hi-ogawa and OpenAI Codex in #10444 (63e3b)
Wait for orchestrator readiness before resolving browser sessions - by @soconnor-seeq in #10397 (fe5ed)
Wait for iframe tester readiness before preparing - by @soconnor-seeq in #10497 (f2655)
Encode iframeId in tester iframe URL - by @Pduhard, Pduhard and Claude Opus 5 (1M context) in #10520 and #10521 (c8bf1)
Always derive a positive locator action timeout - by @sheremet-va in #10626 (5b864)
Resize the browser ui only if it's not headless - by @sheremet-va in #10662 (b5c61)
Check fs access in builtin commands - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10674 (33f96)
Preserve pre-transform request defaults - by @sheremet-va in #10748 (b6060)
Fix error stacktrace location off-by-one - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10724 (62b8d)
Inlined awaited import should not trigger syntax error after transform - by @smeng9, Shaoyu Meng and Claude Opus 5 (1M context) in #10784 (51acd)
Mock window.print to avoid hanging - by @aaravjaichand in #7375 and #10798 (66d95)
Ignore channel events in a tester opened as a top-level window - by @simshanith in #9379 and #9381 (46a3c)
Resolve connectTimeout from the project config - by @lazerg in #10879 and #10880 (62c79)
Prebundle vite module runner with vitest - by @lebovvskii and @sheremet-va in #10836 and #10856 (37c24)
Restore dependency reload warning - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10913 (90d69)
Configure internal optimizer dependencies - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10915 (a72f4)
Trigger playwright/chromium gc on lower disk availability - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10912 (032d3)
Disallow filter-only options in getBy* locators - by Arjun in #10295 and #10933 (9b4df)
Fail instead of hanging when the browser stops responding - by @sheremet-va in #10956 (c496c)
Exit gracefully when the browser disconnects during cancellation - by @sheremet-va in #10962 (67e84)
Don't redirect vitest in client environment - by @sheremet-va in #10975 (aeb67)
Don't hang when ui: true in projects - by @AriPerkkio in #10994 (9f710)
Preserve trace popover state - by @liuluochen6-af, Hiroshi Ogawa, OpenCode (gpt-5.6-sol) and @hi-ogawa in #10906 and #11021 (1bbc2)
Report the action error when a task times out - by @sheremet-va in #11101 (dc10f)

Choose your update

Requirements· 9 changesView changes

1 release to review

5.0.0#

Choose your update

Requirements· 9 changesView changes

1 release to review

5.0.0#

🚨 Breaking Changes

🚀 Features

🐞 Bug Fixes

🏎 Performance

View changes on GitHub

5.0.0

5.0.0