vitest 5.0.0 release notes

semverse.

vitest 5.0.0 release notes · Semverse

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)
Promote parseSpecifications out of experimental - by @sheremet-va in #11087 (b628c)
Promote clearCache out of experimental - by @sheremet-va in #11086 (d4fe1)
api:
- Expose logs recorded during the test - by @sheremet-va in #10277 (cba20)
benchmark:
- Add pluggable benchmark provider API - by @GuillaumeLagrange and @sheremet-va in #10799 (86c70)
browser:
- Export aria tree utils - by @hi-ogawa in #10171 (c3423)
- Support dom snapshot trace view - by @hi-ogawa, Claude Opus 5 (1M context) and OpenAI Codex in #10102 (7eddd)
- Provide project reference in ToMatchScreenshotResolvePath - by @macarie and @sheremet-va in #10138 (16654)
- Show aria tree on locator element error - by @hi-ogawa and OpenAI Codex in #10257 (04f04)
- Support custom kind in page.mark - by @AriPerkkio in #10302 (053e8)
- Live update trace view on watch UI - by @hi-ogawa and OpenAI Codex in #10296 (78c11)
- Add context.mark for custom command tracing - by @AriPerkkio in #10329 (aa514)
- Show trace view steps in editor panel - by @hi-ogawa and OpenAI Codex in #10404 (8c4b6)
- Display nested mark trace in UI - by @hi-ogawa, Hiroshi Ogawa and OpenAI Codex in #10437 (86ffc)
cli:
- Add --repeats CLI option - by @todor-a in #10504 (ee48b)
- Support -p shorthand for --project - by @sheremet-va in #10826 (1addd)
coverage:
- V8 to track node:child_process and node:worker_threads contexts - by @AriPerkkio in #9976 (9baa5)
- thresholds.autoUpdate to receive previous threshold as argument - by @wouterkroes in #10495 (04f81)
- Switch to @vitest/istanbuljs packages - by @AriPerkkio in #11053 (5f6a5)
junit-reporter:
- Add jest-junit-compatible naming options - by @neumaennl, neumaennl, Martin Neumann and Copilot in #10189 (27393)
reporter:
- Support html reporter single file output - by @hi-ogawa, OpenAI Codex and Claude Opus 5 (1M context) in #10235 (f757e)
- Add custom GitHub Actions summary title - by @heyJonBray and @macarie in #10891 (4363c)
ui:
- Highlight editor source locations - by @sheremet-va, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #11004 (bce2d)
- Navigate trace steps with keyboard and remove indirect editor focus - by @sheremet-va, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #11005 (6816f)
- Persist trace view selection in URL - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10981 (3069e)
- Toggle trace target highlight - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #11049 (cd63e)
- Add link to open playwright trace - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #11059 (58f02)
vitest:
- Create vi.when() - by @macarie in #10174 (3900e)
vm:
- Support require(esm) in vm pools - by @sheremet-va in #10829 (01298)

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 Patrick Clausen in #10421 and #10420 (4fee2)
Unify typechecking and ast collection - by @sheremet-va in #10449 (af993)
Don't print typecheck warning more than once - by @sheremet-va in #10461 (15275)
Correct collumn when parsing tests - by @sheremet-va in #10467 (7c2fc)
Fix mixed stdout/stderr log timestamps in onUserConsoleLog - by @Copilot, Hiroshi Ogawa, @hi-ogawa and @sheremet-va in #10308 (62756)
Fix importOriginal with optimizer and query import - by @davidxharris, David Harris, @hi-ogawa, Hiroshi Ogawa and OpenAI Codex in #10469 (6a3bb)
Correct transform time calculation in merged report - by @potatomatoooo and @hi-ogawa in #10570 and #10578 (b7897)
Fix setImmediate await in detect-async-leak - by @hi-ogawa and Hiroshi Ogawa in #10608 (dd62b)
Fix per-project sequence config - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10659 (40cdc)
Add handshake timeout to iframe communication - by @sheremet-va in #10656 (3545f)
Don't print column in test names when includeTaskLocation is enabled - by @sheremet-va in #10681 (bd9cc)
Disable server HMR before plugins read it in their config hook - by @sheremet-va in #10731 (e060b)
Close the pool before the Vite servers - by @sheremet-va in #10725 (96fa6)
Remove listeners in the typecheck worker's off - by @sheremet-va in #10741 (d758b)
Keep per-file isolation in vm pools when maxWorkers is 1 - by @sheremet-va in #10743 (83ab9)
Node.js 20 deprecation warning for ci.yml - by @hirehamir in #10759 (2127f)
Prevent node builtins double prefix - by @malobre in #10630 and #10767 (22d35)
Set non-zero exit code when teardown throws during close - by @zakcutner and @AriPerkkio in #10794 (22116)
Don't race the typechecker spawn grace period on windows - by @xevrion in #10814 (b19e5)
Coalesce concurrent watch-mode restarts, deflake the pool stderr fixture - by @sheremet-va in #10822 (a31f8)
Prevent vitest --typecheck from reporting a false success when the tsc process crashes - by @hitenkalda and Hiten Kalda in #10705 (a1b05)
Collect in-source tests when the module is cached - by @koutaro-masaki in #10577 and #10589 (a7bf2)
Swap replace() arguments so timeout error stack shows the real message - by @lazerg in #10875 (aba0f)
Stale mock metadata breaks automocking with isolate:false - by @kade-robertson in #10145 and #10541 (8e210)
Don't lose worker output on teardown, deflake timing-sensitive tests - by @sheremet-va in #10842 (1216b)
Revive global concurrency limit for test lifecycle - by @hi-ogawa, Hiroshi Ogawa, OpenCode (gpt-5.6-sol) and @sheremet-va in #10928 (cf917)
Own the post-restart rerun, keep process.exit disabled in workers - by @sheremet-va in #10963 (5e69a)
Preserve correct root during resolve config - by @AriPerkkio and @sheremet-va in #10909 (210ba)
Combine multiple --project filters correctly - by @sheremet-va in #10988 (66c1c)
Fix recordArtifact location with vi.defineHelper - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #11047 (c2186)
Invalidate resolved setup files - by @sheremet-va in #11073 and #11081 (488c0)
Accept awaited value in vi.when thenResolve - by @sheremet-va in #11084 (c10a1)
Ignore computed member calls in static collection - by @sheremet-va in #11085 (130f7)
Don't duplicte oxc.target if user provides a custom array - by @sheremet-va in #11095 (848d7)
Propagate --maxWorkers to projects - by @Gaurav1112 in #11102 (2122f)
Apply queued mocks from doMock() in queue order - by @juliandescottes and Claude Opus 5 (1M context) in #10706 and #11127 (f08ce)
Add a warning if inline project has duplicate plugins due to unexpected extends: true - by @sheremet-va in #11120 (584cf)
Treat test.describe as a suite during static collection - by @sheremet-va in #11128 (d46a7)
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)
cache:
- Improve fsModuleCache resiliency during external modifications - by @jszumski in #10869 (5eb35)
cli:
- Respect FORCE_COLOR over agent detection - by @dokson in #10272 (7e66b)
- Exit on CTRL+c even when globalSetup runs blocked code - by @AriPerkkio in #10863 (d568f)
coverage:
- exclude to not inherit negation globs from test.include - by @AriPerkkio in #10299 (28685)
- Avoid matching sibling project roots - by @innoprej, Shin JaeHee and @AriPerkkio in #10311 (e30dd)
- Non-awaited module imports cause wrong offsets - by @AriPerkkio in #10643 (c4090)
- Fail fast when coverage.reportsDirectory conflicts between concurrent runs - by @jgamaraalv and @AriPerkkio in #10466 (833f0)
- V8 to ignore Vite SSR's generated import bindings - by @AriPerkkio in #11023 (c6174)
- Prevent crash on /@fs/ prepended virtual files - by @AriPerkkio in #11119 (c4473)
deps:
- Update ivya to fix empty aria tree snapshot - by @hi-ogawa in #10218 (f7822)
- Update fake-timers to 15.3.2. support toNotFake - by @BPScott, @hi-ogawa and OpenAI Codex in #10043 (bbf2f)
- Update all non-major dependencies - by @sheremet-va in #9958 (7faa7)
- Update all non-major dependencies - by @sheremet-va in #10861 (0188c)
- Update all non-major dependencies - by @sheremet-va in #10898 (61c4b)
- Update all non-major dependencies - in #10966 (65263)
- Update all non-major dependencies - in #11043 (732df)
expect:
- Allow readonly arrays and sets in toBeOneOf - by @YBJ0000 in #10264 and #10374 (fed11)
- Handle nullish toHaveProperty values - by @liyimil in #10735 and #10811 (99e59)
junit:
- Include unhandled errors in JUnit XML report - by @gbleu and Claude Opus 5 (1M context) in #10244 (6f74e)
mocker:
- Skip hoist transform without ast mock calls - by @hi-ogawa and OpenAI Codex in #10410 (0468e)
- Hoist vi.mock() for vite-plus/test imports - by @Brooooooklyn and Claude Opus 5 (1M context) in #10489 (88376)
- Restrict redirect mocks to the fs allowlist - by @sheremet-va in #10972 (8ff9b)
pool:
- Prevent test run hang on worker crash - by @jaxalo and @AriPerkkio in #10543 (40878)
- Improve error message when worker exits unexpectedly - by @filmaj and @AriPerkkio in #10587 (76139)
- Vm pools to respect cgroupsv2 memory limit - by @milas in #10721 (3923c)
- Worker init to handle queued synchronous messages - by @lazerg and @AriPerkkio in #10932 (76096)
- Report the worker exit instead of a pipe error that raced it - by @sheremet-va in #10964 (59a03)
reporter:
- Guard against non-finite slowTestThreshold in summary reporter - by @OfekDanny, Ofek Danny, Claude Opus 5 (1M context) and @AriPerkkio in #10202 (f362f)
- Fix non-existing import subpath module blob serialization - by @hi-ogawa in #10318 (29cb0)
reporters:
- Fix blob file name with label - by @hi-ogawa in #10346 (c5e2e)
- summary to intercept logger's streams even when they are not process.std* streams - by @AriPerkkio in #10340 (f79e7)
- Fix missing testModules in onTestRunEnd when merging blobs from different root directory test runs - by @hi-ogawa and OpenAI Codex in #10348 (745b3)
- Print parent describe suites when the passed-test list is hidden - by @ChihebBENCHEIKH1, Chiheb Bencheikh and @sheremet-va in #10606 and #10768 (658af)
- Display test.name in GitHub Actions reporter summary header - by @macarie in #10887 (49e24)
runner:
- Propagate chainable flags in describe.for - by @DoriAlagem, Dor Alagem and @hi-ogawa in #10187 (db678)
- Limit concurrency per task branch in addition to per leaf callbacks - by @hi-ogawa in #10179 (3112a)
- Remove AbortSignal listener leak in withCancel - by @tomohiro86 and @AriPerkkio in #10265 (ab098)
- Don't fail collection when accessing error.stack throws - by @sheremet-va in #10839 (202e2)
snapshot:
- Fail test when snapshot assertion is used with test.fails - by @hi-ogawa in #10090 (e1aa7)
- Treat empty string as valid snapshot - by @mayrang and @hi-ogawa in #10188 (e145d)
- Support no-unsafe-eval CSP by evaluating snapshot files on server - by @hi-ogawa in #10665 (667c1)
- Reject when toMatchFileSnapshot uses same snapshot file as toMatchSnapshot - by @hi-ogawa, Hiroshi Ogawa, OpenCode (gpt-5.6-sol) and @sheremet-va in #10978 (17646)
spy:
- Support private method spy types - by @cyphercodes in #10172 and #10213 (628ab)
- Point ESM namespace spy error to module mocking docs - by @ryandiginomad and Ryan Tang in #10707 (d6cec)
typecheck:
- Report a checker crash on Windows instead of a spawn failure - by @sheremet-va in #10907 (77aac)
types:
- Allow changed in configuration options - by @AriPerkkio in #10651 (0da12)
ui:
- Fix duplicate colored error message - by @hi-ogawa and OpenAI Codex in #10258 (035e3)
- Fix missing source code in html reporter metadata when merging blobs with different root directory test runs - by @hi-ogawa and OpenAI Codex in #10338 (4f7c2)
- Fix module graph in browser mode with --ui - by @hi-ogawa in #10386 (3003c)
- Render ANSI color codes in editor panel inline error widget - by @Copilot, Hiroshi Ogawa and @hi-ogawa in #10418 (766b8)
- Fix code editor error and annotations gadgets layout shifts - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10969 (438ed)
- Synchronize watch-run UI state on file removal - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10941 (30c21)
- Require auth for coverage report and all UI subtree requests - by @sheremet-va in #10971 (5622f)
- Improve suite interaction and layout in explorer tree - by @hi-ogawa, Hiroshi Ogawa and OpenCode (gpt-5.6-sol) in #10970 (91231)
- Reveal explorer virtual scroller on resize - by @hi-ogawa, and in
utils:
- Don't crash on a malformed inline source map - by @lazerg, Hiroshi Ogawa, OpenCode (gpt-5.6-sol) and @hi-ogawa in #10892 and #10893 (fe790)
vitest:
- Strip non-serializable functions from inline diff config - by @DucMinhNe in #10573 (5b81a)
- Remove broken "./src/*" export from package.json - by @sheremet-va in #10918 (2e5df)
- Render non-Error causes from env setup so the actual diagnostic is not dropped - by @spokodev in #10567 (b298d)
vm:
- Fix external module resolve error with deps optimizer query for encoded URI - by @SveLil in #10658 (90c4e)
- Stop retaining every finished test file in vm pool workers - by @sheremet-va in #10854 (38503)
- Fall back to compiling from source when a module's code cache is rejected - by @MarshallOfSound in #11031 (c3ba1)
- Link module graphs one at a time - by @sheremet-va in #11096 (3f2dd)
webdriverio:
- Allow gpu in headless chrome - by @rotempasharel1 in #10376 (f310a)
worker:
- Bind stdio's early in case overriden - by @AriPerkkio in #11020 (67ef7)

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 (6db8d)
- Cut per-file round trips - by @sheremet-va in #10730 (3feef)
- Stop serving framework sourcemaps in headless runs - by @sheremet-va in #10728 (6aefb)
- Prewarm the browser while the Vite server starts - by @sheremet-va in #10727 (c1767)
- Pre-bundle the vitest runtime in optimizeDeps - by @sheremet-va in #10713 (de631)
- Serve framework assets as immutable - by @sheremet-va in #10729 (7af87)
cache:
- Hash the environment-invariant part of the fs module cache key once - by @MarshallOfSound in #11029 (1d365)
coverage:
- Speed up v8 report generation (bounded-memory merge + precompiled globs) - by @toxik, Claude Opus 5 (1M context) and @AriPerkkio in #10506 (b05e5)
- Reduce RPC data and unnecessary serializations - by @AriPerkkio in #10781 (7e7e3)
expect:
- Avoid redefining matcher state - by @scttcper and OpenAI Codex in #11048 (58e71)
- Lazily format spy matcher failures - by @scttcper and OpenAI Codex in #11090 (e08c4)
spy:
- Avoid scanning cleared mocks - by @scttcper and OpenAI Codex in #11092 (2451e)
vm:
- Don't prewarm modules the worker never requests - by @MarshallOfSound and @sheremet-va in #11033 (1e9f8)
- Let environments opt out of the module graph prewarm - by @sheremet-va in #11078 (a6d5e)

vitest

5.0.0

🚨 Breaking Changes

5.0.0

🚨 Breaking Changes

🚀 Features

🐞 Bug Fixes

🏎 Performance

View changes on GitHub

5.0.0#

🚨 Breaking Changes

5.0.0#

🚨 Breaking Changes

🚀 Features

🐞 Bug Fixes

🏎 Performance

View changes on GitHub

5.0.0

5.0.0