Vitest v1.4.0 — Release Notes & Engineering Impact

Source available — automated, not human-reviewed

Component: vitest · Channel: stable. Automated analysis, not a compatibility certification. How this works.

Analysis updated: 2026-11-01.

Compatibility not verified — check source notes

📄 .MD

✨ Features 6 🔧 Bug Fixes 6

⚡ Executive Summary (TL;DR)

Vitest v1.4.0. Source highlight:    🚀 Features

Visit Vitest Official Site ↗ Official Release Source ↗ All Vitest Releases 📡 Vitest RSS

Who Does This Impact? (Role-Based Analysis)

💻 Software Engineers & Devs

Check the source notes against the package and APIs you use before upgrading.

📊 Product & Engineering Leads

Use the documented changes to assess relevance to your product; release frequency alone is not a quality measure.

⚙️ DevOps & Security

Verify the target version, runtime requirements and rollback procedure in the official documentation.

✨ New Features & Capabilities (6)

Throw error when using snapshot assertion with `not`  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5294 <samp>(b9d37)</samp>
Add a flag to include test location in tasks  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5342 <samp>(d627e)</samp>
Support wildcards in `--project` option  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5295 <samp>(201bd)</samp>
Add `shuffle.files` and `shuffle.tests` options  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5281 <samp>(356db)</samp>
Deprecate `cache.dir` option  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5229 <samp>(d7e8b)</samp>
Support `--changed` option  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5314 <samp>(600b4)</samp>

🔧 Bug Fixes & Patches (6)

Repeatable `--project` option  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5265 <samp>(d1a06)</samp>
`--inspect-brk` to pause before execution  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5355 <samp>(e77c5)</samp>
Correct locations in test.each tasks  -  by @sheremet-va <samp>(4f6e3)</samp>
Use resolvedUrls from devserver  -  by @saitonakamura and @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5289 <samp>(2fef5)</samp>
Add `magic-string` to `optimizeDeps.include`  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5278 <samp>(8f04e)</samp>
Expensive regexp hangs v8 report generation  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5259 <samp>(d68a7)</samp>

📄 View Raw Release Notes (Original Developer Log)

###    🚀 Features - Throw error when using snapshot assertion with `not`  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5294 [<samp>(b9d37)</samp>](https://github.com/vitest-dev/vitest/commit/b9d378f5) - Add a flag to include test location in tasks  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5342 [<samp>(d627e)</samp>](https://github.com/vitest-dev/vitest/commit/d627e209) - **cli**: - Support wildcards in `--project` option  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5295 [<samp>(201bd)</samp>](https://github.com/vitest-dev/vitest/commit/201bd067) - **config**: - Add `shuffle.files` and `shuffle.tests` options  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5281 [<samp>(356db)</samp>](https://github.com/vitest-dev/vitest/commit/356db87b) - Deprecate `cache.dir` option  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5229 [<samp>(d7e8b)</samp>](https://github.com/vitest-dev/vitest/commit/d7e8b53e) - **coverage**: - Support `--changed` option  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5314 [<samp>(600b4)</samp>](https://github.com/vitest-dev/vitest/commit/600b44d6) - **vitest**: - Support `clearScreen` cli flag  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5241 [<samp>(e1735)</samp>](https://github.com/vitest-dev/vitest/commit/e1735fb6) ###    🐞 Bug Fixes - Repeatable `--project` option  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5265 [<samp>(d1a06)</samp>](https://github.com/vitest-dev/vitest/commit/d1a06730) - `--inspect-brk` to pause before execution  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5355 [<samp>(e77c5)</samp>](https://github.com/vitest-dev/vitest/commit/e77c553f) - Correct locations in test.each tasks  -  by @sheremet-va [<samp>(4f6e3)</samp>](https://github.com/vitest-dev/vitest/commit/4f6e39c1) - **api**: - Use resolvedUrls from devserver  -  by @saitonakamura and @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5289 [<samp>(2fef5)</samp>](https://github.com/vitest-dev/vitest/commit/2fef5a7e) - **browser**: - Add `magic-string` to `optimizeDeps.include`  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5278 [<samp>(8f04e)</samp>](https://github.com/vitest-dev/vitest/commit/8f04e798) - **coverage**: - Expensive regexp hangs v8 report generation  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5259 [<samp>(d68a7)</samp>](https://github.com/vitest-dev/vitest/commit/d68a7390) - V8 to ignore type-only files  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5328 [<samp>(c3eb8)</samp>](https://github.com/vitest-dev/vitest/commit/c3eb8deb) - Respect source maps of pre-transpiled sources  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5367 [<samp>(6eda4)</samp>](https://github.com/vitest-dev/vitest/commit/6eda473f) - Prevent `reportsDirectory` from removing user's project  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5376 [<samp>(07ec3)</samp>](https://github.com/vitest-dev/vitest/commit/07ec3779) - **expect**: - Show diff on `toContain/toMatch` assertion error  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5267 [<samp>(8ee59)</samp>](https://github.com/vitest-dev/vitest/commit/8ee59f0d) - **forks**: - Wrap `defines` to support `undefined` values  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5284 [<samp>(5b58b)</samp>](https://github.com/vitest-dev/vitest/commit/5b58b399) - **typecheck**: - Update get-tsconfig 4.7.3 to fix false circularity error  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5384 [<samp>(bdc37)</samp>](https://github.com/vitest-dev/vitest/commit/bdc371ee) - **ui**: - Escape html in error diff  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5325 [<samp>(ab60b)</samp>](https://github.com/vitest-dev/vitest/commit/ab60bf8d) - **vitest**: - Loosen `onConsoleLog` return type  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5337 [<samp>(6d1b1)</samp>](https://github.com/vitest-dev/vitest/commit/6d1b1451) - Ensure restoring terminal cursor on close  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5292 [<samp>(0bea2)</samp>](https://github.com/vitest-dev/vitest/commit/0bea2247) - Ignore timeout on websocket reporter rpc  -  by @sheremet-va [<samp>(38119)</samp>](https://github.com/vitest-dev/vitest/commit/38119b75) - Correctly override api with --no-api flag  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5386 [<samp>(51d1d)</samp>](https://github.com/vitest-dev/vitest/commit/51d1d472) - Logs in `beforeAll` and `afterAll`  -  by @fenghan34 in https://github.com/vitest-dev/vitest/issues/5288 [<samp>(ce5ca)</samp>](https://github.com/vitest-dev/vitest/commit/ce5ca6bf) - **workspace**: - Throw error when browser mode and `@vitest/coverage-v8` are used  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5250 [<samp>(29f98)</samp>](https://github.com/vitest-dev/vitest/commit/29f98cd3) #####     [View changes on GitHub](https://github.com/vitest-dev/vitest/compare/v1.3.1...v1.4.0)

← Older Version Vitest v1.3.1 Newer Version → Vitest v1.5.0