Vitest 2.0 is here! This release page lists all changes made to the project during the beta. For the migration guide, please refer to the documentation.

🚨 Breaking Changes

• Simplify mock function generic types and align with jest - by @hi-ogawa in https://github.com/vitest-dev/vitest/pull/4784 (a0c1d37)
• Remove --segfault-retry - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5514 (ed60e)
  • This flag was introduced to combat threads segfaults. Our current recommendation is to use the new default forks pool instead.
• Run suite hooks in a stack - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5609 (1277d)
  • This feels like a more sensible default. Especially with the new onTestFinished hook. This can make your tests run a little bit slower.
• Enable coverage.ignoreEmptyLines by default - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5543 (31994)
  • ⚠️ This change may cause significant differences in your coverage results compared to Vitest v1. These changes are expected as coverage reporting is now more accurate. See https://github.com/vitest-dev/vitest/issues/5423 for more details.
• Add correct location and snapshot fields in json reporter - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5434 (bcccc)
  • Previously, the location field pointed to the error location instead of the test location. Now it is aligned with jest and contains the line and column of a test function, but requires includeTaskLocation to be enabled.
• Update dependency chai to v5 - by renovate[bot] and @sheremet-va in https://github.com/vitest-dev/vitest/issues/5135 (73646)
• Remove watchExclude - by @patak-dev in https://github.com/vitest-dev/vitest/issues/5177 (d7371)
• Change default pool to 'forks' - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5047 (7f8f9)
  • This change is done for compatibility issues
  • This pool may be slightly slower than previous threads pool: https://vitest.dev/guide/improving-performance.html#pool
• --merge-reports to support coverage - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5736 (b7438)
• Add promise-based return assertions, do not auto-resolve returned promises - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5749 (5f710)
  • ⚠️ Vitest no longer unwraps promises in spy.mock.returns. If the function is async or returns a promise, it will always succeed and have a Promise in results. To make migration easier, we introduced spy.mock.settledResults that unwraps promises and expect().toHaveResolved() matcher that accepts unwrapped value.
• Do not exit process if global setup has failed - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5726 (ddb09)
• Don't exit process if config failed - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5715 (f232f)
• Add meta to json output - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5802 (dd754)
• Rename indexScripts to orchestratorScripts in the browser config - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5842 (49f34)
• Add "vitest list" API to print collected tests without running them - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6013 (583dd)
  • ⚠️ This changes the custom pool API - now requires collectTests method alongside runTests.
• Remove the empty suite from the runner - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5435 (dbbbe)
• Support concurrent suites - by @hi-ogawa in https://github.com/vitest-dev/vitest/pull/5491 (222ce44)
• Support overriding exclude in coverage - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5997 (169bc)
  • ⚠️ Vitest coverage no longer adds test files to exclude patterns if coverage.exclude was overridden in the config. Add your test patterns manually, or merge your overrides with default ones: ['**/my-pattern.js', ...coverageConfigDefaults.exclude]. See https://vitest.dev/config/#coverage-exclude for an example.

🚀 Features

• browser:
  • 🌐 This release lays the groundwork for the next iteration of Vitest Browser Mode. You can read more about our future plans at https://github.com/vitest-dev/vitest/discussions/5828
  • Add commands to communicate betweens server and the browser - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5097 (aa431)
  • Do not reload the page during watch mode - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5810 (e5b9a)
  • Support changing the viewport - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5811 (71851)
  • Add browser iframe mouse interaction - by @userquin in https://github.com/vitest-dev/vitest/issues/5815 (f29b9)
  • Support click event - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5777 (839c3)
  • Rename none provider to preview, make it default - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5826 (18310)
  • Run tests in parallel in headless mode, add page.screenshot method - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5853 (81c42)
  • Implement several userEvent methods, add fill and dragAndDrop events - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5882 (4dbea)
  • Introduce expect.dom method and bundle jest-dom matchers with @vitest/browser - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5910 (3a96a)
  • Expose CDP in the browser - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5938 (bec43)
  • Add "init" command for browser tests - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5960 (49e97)
  • Add an option to take screenshots if the browser test fails - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5975 (154cb)
  • Add tripleClick to interactive api - by @userquin in https://github.com/vitest-dev/vitest/issues/5987 (200a4)
  • Playwright provider doesn't allow resizing the browser viewport - by @userquin and @sheremet-va in https://github.com/vitest-dev/vitest/issues/5984 (ff978)
• Pretty print diffs coming from cause - by @dubzzz in https://github.com/vitest-dev/vitest/issues/5660 (6faf8)
• Allow import statement as vi.mock path for better IDE support - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5690 (a99a1)
• Remove deprecated options - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5696 (5c308)
• Add blob reporter - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5663 (e2053)
  • ✅ Run Vitest in separate processes with --reporter=blob flag to generate reports and combine them with vitest --merge-reports later!
• Add expect.poll utility - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5708 (e2e0f)
• Add browser.ui option - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5771 (a5033)
• Add median to --output-json - by @Joristdh in https://github.com/vitest-dev/vitest/issues/5745 (0766b)
• Allow augmenting config.test.env - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5784 (b2469)
• Implement module mocking in browser mode - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5765 (7b2f6)
• Allow configuring expect options in the config - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5729 (fc53f)
• Add an option to print console stack trace - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5720 (e4fe6)
• Add browser frame to UI - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5808 (3796d)
• Image type add bmp - by btea in https://github.com/vitest-dev/vitest/issues/5921 (98f9b)
• Add an option to return base64 from page.screenshot - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5993 (be323)
• Expose parseAst, parseAstAsync from vite - by @sheremet-va (f645e)
• config:
  • Allow percentage value for workers option - by @syi0808 in https://github.com/vitest-dev/vitest/issues/5982 (b1a27)
• runner:
  • Implement test.for - by @hi-ogawa and @sheremet-va in https://github.com/vitest-dev/vitest/issues/5861 (c2380)
• spy:
  • Collect mock.contexts - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5955 (3b31a)
• ui:
  • Render tests in a tree - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5807 (7900f)
  • Load module graph on tab selection - by @userquin in https://github.com/vitest-dev/vitest/issues/5844 (b117e)
  • Replace navigation tree with test explorer - by @userquin in https://github.com/vitest-dev/vitest/issues/5907 (45dfc)
  • Add initializing explorer logic - by @userquin in https://github.com/vitest-dev/vitest/issues/5941 (c31c4)
  • Add action to explorer item to show the test/suite line in the source code tab - by @userquin and Anjorin Damilare in https://github.com/vitest-dev/vitest/issues/5948 (7ec29)
• ws-client:
  • Allow change reactive for state, filesMap and idMap - by @userquin in https://github.com/vitest-dev/vitest/issues/5906 (e6020)

🐞 Bug Fixes

• Print console statements in vmThreads - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5678 (34a80)
• Repeatable --exclude option - by @fregante in https://github.com/vitest-dev/vitest/issues/5782 (d6700)
• Remove browser.fileParallelism - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5790 (b881e)
• Install UI icons - by @sheremet-va (b84f1)
• Remove process.exit if workspace project failed to be created - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5804 (a820e)
• Vi.waitFor/vi.waitUntil interval is now cleared after it times out - by @pedro00dk in https://github.com/vitest-dev/vitest/issues/5875 (04107)
• ToJSON recursive error serialization - by @eddienubes in https://github.com/vitest-dev/vitest/issues/5848 and https://github.com/vitest-dev/vitest/issues/5884 (8d55d)
• Print error properties only in verbose reporter - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5917 (2bd8d)
• Use TTY reporter when running in Deno - by @marvinhagemeister in https://github.com/vitest-dev/vitest/issues/5972 (e0f45)
• Don't override uppercase - by @sheremet-va (caef4)
• Clear screen and scrollback on iTerm2 - by @kxalex in https://github.com/vitest-dev/vitest/issues/5978 (d7f23)
• Include pretty-format in @vitest/runner for optimization on npm - by @sheremet-va (42bd4)
• Transpile esnext to node18 to support newest JS and TS features - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/4409 (8f65a)
• api:
  • Correct project.provide type - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5959 (0eda9)
  • Don't call process.exit manually - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5926 (e9b63)
• browser:
  • Display UI - by @sheremet-va (d41e4)
  • Browser actions icons colors - by @userquin in https://github.com/vitest-dev/vitest/issues/5816 (f9d9b)
  • Restore the original viewport when unselecting the preset viewport - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5821 (5ebb3)
  • Don't get stuck after the manual page refresh - by @sheremet-va (2220b)
  • Use iframe id instead of calculating it from filenames - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5823 (34a31)
  • Always clean up iframes on rerun - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5827 (087fa)
  • Support @testing-library/vue in browser mode out of the box - by @sheremet-va (76b82)
  • Print correct transformed module graph - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5833 (a7581)
  • Use preview provider when running in StackBlitz - by @userquin in https://github.com/vitest-dev/vitest/issues/5836 (76e13)
  • Specify entries for correct deps optimization - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5839 (c79b3)
  • Allow iframe to load even if there is a custom CSP header - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5841 (caaaf)
  • Don't optimize Vitest dependencies - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5843 (f15b4)
  • Set server.open to false and move error handling after init - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5845 (47003)
  • Show correct prepare time - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5852 (52d54)
  • Resolve coverage.reporter from string values - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5920 (f33da)
  • Correctly update inline snapshot if changed - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5925 (2380c)
  • Remove "util" warning - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5935 (48f28)
  • Remove hacky retry - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5971 (2a2c9)
  • Make userEvent more stable when running in parallel - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5974 (14a21)
  • Print screenshot path alongside the test error message - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5992 (15289)
  • Print correct stack trace in source files - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6003 (62aa7)
  • Correctly mock optimized cjs dependencies - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6035 (057b4)
  • Support shadow root and svg elements - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6036 (2e3c8)
• coverage:
  • Clean up empty coverage reports directory - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5731 (c469c)
  • thresholds.autoUpdate to support mergeConfig - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5818 (7afb3)
  • Pass thresholds errors to stderr of startVitest() - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5954 (70805)
  • Exclude bench files from coverage - by @kouak in https://github.com/vitest-dev/vitest/issues/5983 (429e1)
  • Vite to ignore dynamic import of provider - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5998 (6d884)
  • Istanbul to support import attributes - by @Gravitonic in https://github.com/vitest-dev/vitest/issues/6006 (2898a)
  • Remove work-around for implicit else - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6014 (368c1)
• deps:
  • Update dependency @testing-library/dom to v10 - by renovate[bot] in https://github.com/vitest-dev/vitest/issues/5866 (e9745)
  • Update vulnerable test-exclude to v7 - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5867 (0a715)
• expect:
  • Fix immutable.js iterable equality - by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5692 (1532c)
• forks:
  • Resolve poolOptions.<name>.isolate from forks options - by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/5840 (a60a1)
• runner:
  • Ensure inner suite { sequential: true } correctly overrides outer suite { concurrent: true } - by @pengooseDev in https://github.com/vitest-dev/vitest/issues/5737 (a20e7)
  • Ensure test.each print -0 and -NaN properly - by @pengooseDev in https://github.com/vitest-dev/vitest/issues/5806 (9ac8f)
• snapshot:
  • Fix toMatchFileSnapshot with empty file - by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5894 (88006)
• spy:
  • Correctly track constructor's "this" type - by @sheremet-va (4776e)
• types:
  • Mark pool options as not available in project config - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5934 (486fd)
• ui:
  • Show correct module graph and project name in a Vitest workspace - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5792 (48c50)
  • Update running todo tests inside todo suites (each) - by @userquin in https://github.com/vitest-dev/vitest/issues/5939 (63ae1)
  • FileDetails title status icon not being updated - by @userquin in https://github.com/vitest-dev/vitest/issues/5942 (e9ddf)
• ui, browser:
  • Disable mouse events when resizing main navigation panel - by @userquin in https://github.com/vitest-dev/vitest/issues/5863 (7cbd9)
• utils:
  • Produce valid snapshot names - by @dubzzz in https://github.com/vitest-dev/vitest/issues/5724 (1ec61)
  • Fix color util maximum call stack error - by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/5733 (a4ec5)
  • Package exports - by @userquin in https://github.com/vitest-dev/vitest/issues/5847 (07876)
• vite-node:
  • Expose all envs from .env file, not just with a prefix VITE_ - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6017 (d87be)
• vitest:
  • Expose provide to the public API - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5897 (66e64)
  • Cache fs code only for forks pool - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/5909 (e30d9)
  • Allow testing unandled rejection/exception - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6016 (c8d56)
  • Show all failed tests when rerunning a test - by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6022 (91ba6)

View changes on GitHub