v3.0.0-beta.1

We decided to skip Vitest 2.2 and release Vitest 3 with support for Vite 6 instead. There will be no more Vitest 2 versions. Vitest 3 is the first version that supports Vite 6 (excluding 2.1.6). We aim to have a stable release in January.

Vitest 3 is our first step to standardising the public Node.js API. We plan to remove the experimental tag from the current APIs in Vitest 3.1 - the API will follow semver after that.

   🚨 Breaking Changes

• spy.mockReset changes  -  by @Lordfirespeed in #6426 (db7a8)
• Pass down context to test hooks  -  by @sheremet-va in #7034 (82c2e)
• Support Vite 6  -  by @sheremet-va in #7026 (7abe8)
• runner: Support describe(..., { shuffle: boolean }) and inherit from parent suite  -  by @hi-ogawa in #6670 (aa1da)
• snapshot: Reset snapshot state for retry and repeats  -  by @hi-ogawa in #6817 (e8ce9)
• vitest: Don't expose default toFake config  -  by @sheremet-va in #6288 (e3144)

   🚀 Features

• Support inline diff options and support printBasicPrototype  -  by @hi-ogawa, @sheremet-va and Michał Grzegorzewski in #6740 (39186)
• Allow a custom note when calling ctx.skip() dynamically  -  by @sheremet-va in #6805 (697c3)
• Allow inline workspace configuration  -  by @sheremet-va in #6923 (562e1)
• Provide the current project to the global setup  -  by @sheremet-va in #6942 (a5bbc)
• Print project name as a label  -  by @sheremet-va in #6925 (a3bef)
• Print a deprecation warning if suite or test uses object as the third argument  -  by @sheremet-va in #7031 (407f1)
• browser:
  • Support actionTimeout as playwright provider options  -  by @hi-ogawa in #6984 (e2c29)
• cli:
  • Support excluding projects with --project=!pattern  -  by @haines in #6924 (ebfe9)
  • Support specifying a line number when filtering tests  -  by @mzhubail and @sheremet-va in #6411 (4d94b)
• expect:
  • Add toHaveBeenCalledExactlyOnceWith expect matcher  -  by @jacoberdman2147 and @sheremet-va in #6894 (ff662)
  • Add toHaveBeenCalledAfter and toHaveBeenCalledBefore utility  -  by @Barbapapazes and @sheremet-va in #6056 (85e6f)
• reporter:
  • Add support for function type to classname option in the junit reporter  -  by @jpleclerc, Jean-Philippe Leclerc and @hi-ogawa in #6839 (dc238)
• reporters:
  • summary option for verbose and default reporters  -  by @AriPerkkio in #6893 (511b7)
• runner:
  • Test context can inject values from the config's provide  -  by @sheremet-va in #6813 (85c64)
• snapshot:
  • Provide config to resolveSnapshotPath  -  by @hi-ogawa in #6800 (746d8)
• ui:
  • Allow run individual tests/suites from the UI  -  by @userquin in #6641 (d9cc8)
• vitest:
  • Include coverageMap in json report  -  by @sheremet-va in #6606 (9c8f7)
  • Add onTestsRerun method to global setup context  -  by @sheremet-va in #6803 (e26e0)

   🐞 Bug Fixes

• Misc fix for vite 6 ecosystem ci  -  by @hi-ogawa in #6867 (80f8b)
• Respect cacheDir when optimizer is enabled  -  by @hi-ogawa in #6910 (0b08b)
• Reset runningPromise after finally in case there is an error to avoid it getting stuck  -  by @sheremet-va in #6951 (02194)
• Support Node 21  -  by @sheremet-va (92f7a)
• Don't use Custom internally  -  by @sheremet-va (46fc5)
• browser:
  • Improve source maps when vi.mock is present  -  by @sheremet-va in #6810 (8d179)
  • Explain TypeScript support in docs and add asymmetric matchers to types  -  by @sheremet-va in #6934 (ac1a7)
  • Fix matchers.d.ts  -  by @hi-ogawa in #6995 (a485b)
• coverage:
  • Exclude browser mode iframe results  -  by @AriPerkkio in #6905 (e04a1)
• junit:
  • Fix testsuites time to be sum of all testsuite items  -  by @saitonakamura in #6985 (ca37a)
• pretty-format:
  • Support react 19  -  by @hi-ogawa in #6909 (bd29b)
• reporters:
  • Write buffered stdout/stderr on process exit  -  by @AriPerkkio in #6932 (80cde)
  • Rewrite dot reporter without log-update  -  by @AriPerkkio in #6943 (be969)
  • Check --hideSkippedTests in base reporter  -  by @AriPerkkio in #6988 (721a5)
  • Show retry and repeats counts  -  by @AriPerkkio and @hi-ogawa in #7004 (3496a)
• typecheck:
  • Fix typecheck collect on Vite 6  -  by @hi-ogawa in #6972 (7b35d)
• types:
  • Make parameters non-nullable for Playwright options  -  by @apple-yagi in #6989 (fe2a1)
• vite-node:
  • Fix error stack on Windows  -  by @hi-ogawa in #6786 (bf7b3)

    View changes on GitHub