# Vitest v5.0.0 — Release & Upgrade Intelligence
- **Product:** Vitest (https://vitest.dev)
- **Version:** v5.0.0
- **Released:** Sep 03, 2026
- **Impact Score:** 7/10
- **Breaking Changes:** Source flagged
- **Canonical Analysis:** https://changelogs.us/vitest/updates/v5.0.0/

## Executive Summary (TL;DR)
Vitest v5.0.0. Source highlight: 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 & Deprecations
- &nbsp;&nbsp;&nbsp;🚨 Breaking Changes - Replace `loupe.inspect` with pretty-format &nbsp;-&nbsp; by @hi-ogawa, **Claude Opus 5 (1M context)** and **OpenAI Codex** in https://github.com/vitest-dev/vitest/issues/9609 [<samp>(3f802)</samp>](https://github.com/vitest-dev/vitest/commit/3f802da4b)

## New Features
- `toHaveTextContent` is strict, add `toMatchTextContent` as alternative &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10473 <samp>(18f30)</samp>
- Add `screenshotDirectory` config to `browser.expect.toMatchScreenshot` &nbsp;-&nbsp; by @macarie in https://github.com/vitest-dev/vitest/issues/10592 <samp>(a60de)</samp>
- Add better promise support in expects and matchers &nbsp;-&nbsp; by @samchungy and @sheremet-va in https://github.com/vitest-dev/vitest/issues/8266 <samp>(41f55)</samp>
- Add `createReport` and `.vitest` report directory convention &nbsp;-&nbsp; by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/9993 <samp>(72a6d)</samp>
- Expose default reporters through `configDefaults.reporters` &nbsp;-&nbsp; by @hi-ogawa and **Claude Opus 5 (1M context)** in https://github.com/vitest-dev/vitest/issues/10219 <samp>(083f6)</samp>
- Support merge reports for non-sharded multi-environment runs (take 2) &nbsp;-&nbsp; by @hi-ogawa, **Claude Opus 5 (1M context)**, **OpenAI Codex** and @AriPerkkio in https://github.com/vitest-dev/vitest/issues/10031 <samp>(e60b2)</samp>

## Improvements
- Allow `thresholds.perFile` to accept an object &nbsp;-&nbsp; by @vladlenskiy and @AriPerkkio in https://github.com/vitest-dev/vitest/issues/10190 <samp>(13b78)</samp>
- Stringify diff objects only once &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10276 <samp>(d006a)</samp>
- Improve performance in hot paths &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10446 <samp>(03faf)</samp>
- Serve warm modules to workers in one round-trip, enable the node compile cache &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10708 <samp>(b144a)</samp>
- Make the Node compile cache opt-in, persist worker caches on teardown &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10742 <samp>(941bc)</samp>
- Reuse compiled code across vm pool contexts and prewarm the module graph &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10744 <samp>(d8b04)</samp>

## Bug Fixes
- Fix `toThrow("")` behavior by reverting #6710 &nbsp;-&nbsp; by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/9643 and https://github.com/vitest-dev/vitest/issues/6710 <samp>(6c3e4)</samp>
- Global `sequence.concurrent: true` with top-level `test(..., { concurrent: false })` + depreacte `sequential` test API and options &nbsp;-&nbsp; by @hi-ogawa, **OpenAI Codex** and @sheremet-va in https://github.com/vitest-dev/vitest/issues/10194 <samp>(9387f)</samp>
- Test `tags` options should overwrite inherited suite options + inherit suite options in `task` API &nbsp;-&nbsp; by @hi-ogawa and **OpenAI Codex** in https://github.com/vitest-dev/vitest/issues/10216 <samp>(457db)</samp>
- Udpate optimize deps config &nbsp;-&nbsp; by @sheremet-va in https://github.com/vitest-dev/vitest/issues/10223 <samp>(95dc6)</samp>
- Shell injection safety via github.ref_name in publish workflow &nbsp;-&nbsp; by @lloyd-c137 and **lloyd-c137** in https://github.com/vitest-dev/vitest/issues/10327 <samp>(dd020)</samp>
- Make `attachmentsDir` root only config &nbsp;-&nbsp; by @hi-ogawa and **OpenAI Codex** in https://github.com/vitest-dev/vitest/issues/10334 <samp>(fab1b)</samp>
