This release makes another big change to the Browser Mode by introducing locators API:

test('renders blog posts', async () => {
  const screen = page.render(<Blog />)

  await expect.element(screen.getByRole('heading', { name: 'Blog' })).toBeInTheDocument()

  const [firstPost] = screen.getByRole('listitem').all()

  await firstPost.getByRole('button', { name: 'Delete' }).click()

  expect(screen.getByRole('listitem').all()).toHaveLength(3)
})

You can use either vitest-browser-vue, vitest-browser-svelte or vitest-browser-react to render components and make assertions using locators. Locators are also available on the page object from @vitest/browser/context.

Potential Breaking Change

• workspace:
  • Correctly resolve workspace globs and file paths  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6316 (afdcb)
  • This changes how the custom glob pattern in the workspace config is treated. Any file matching the glob is considered a Vitest config file. Any folder matching the glob pattern is treated as a workspace project and is subject to the regular config resolution (single vitest.config.ts or vite.config.ts inside the folder)
  • For example, projects/* will match anything inside the projects folder. If it's a folder, we try to find the config inside that folder (if there is none, it is still treated as a project with the default config). If it's a file, it will be treated as a Vitest config. projects/**/* previously would assume that you only wanted to have folders as projects, but now it will match every single file insideprojects.
  • This change doesn't affect non-glob usage.

   🚀 Features

• api:
  • Make spec into a class instead of a tuple  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6355 (874a1)
• browser:
  • Move page.config to server.config, add more docs  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6252 (af2b8)
  • Make iframe scalable, improve documentation  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6257 (74ca1)
  • Introduce built-in locators  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6084 (3347f)
  • Support v8 coverage  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6273 (34199)
  • Support userEvent.upload in playwright provider  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6442 (cf148)
  • Support --inspect  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6433 (0499a)
  • Support --inspect-brk  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6434 (7ab0f)
• cli:
  • Extend existing list command to output only a list of file names  -  by @Ma-hawaj and @sheremet-va in https://github.com/vitest-dev/vitest/issues/6392 (008f0)
• coverage:
  • Add --exclude-after-remap  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6309 (5932a)
• mocker:
  • Introduce @vitest/mocker package, allow { spy: true } instead of a factory  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6289 (95f02)
• vitest:
  • Add "provide" option  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6253 (4409d)
  • Add return type and promisable mockFactory  -  by @syi0808 and @sheremet-va in https://github.com/vitest-dev/vitest/issues/6139 (f5e0b)
  • Add vi.advanceTimersToNextFrame  -  by @bnjm and @sheremet-va in https://github.com/vitest-dev/vitest/issues/6347 (8ff63)
  • Allow env to be stubbed to undefined  -  by @JSanchezIO and @sheremet-va in https://github.com/vitest-dev/vitest/issues/6359 (c3b27)
• Migrate from fast-glob to tinyglobby  -  by @SuperchupuDev in https://github.com/vitest-dev/vitest/pull/6274 (c321a)

   🐞 Bug Fixes

• Correctly resolve nested mocks with index file  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6266 (081cf)
• Don't panic when coverage.reporter is a string  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6267 (7b37d)
• Align RawMatcherFn type definition with Jest  -  by @wheresrhys in https://github.com/vitest-dev/vitest/issues/6351 (d09f0)
• Cjs build of vite node server  -  by @AkaraChen in https://github.com/vitest-dev/vitest/issues/6389 (12e70)
• Allow inlining vite's cached dependencies  -  by @chriswheeldon-peakon in https://github.com/vitest-dev/vitest/issues/6284 (03208)
• Print unexpected error message if peer dependencies have a different version  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6446 (b992b)
• Ignore importer when resolving Vitest  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6469 (0b447)
• expect.getState().testPath always returns correct path  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6472 (ac698)
• UserEvent works consistently between providers  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6480 (0b4da)
• browser:
  • Print correct stack trace for unhandled errors  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6134 (1da6c)
  • Use documentElement as the root for selector  -  by @sheremet-va (d8077)
  • Keep querying elements even if locator is created with elementLocator, add pubic @vitest/browser/utils  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6296 (30dc5)
  • Produce valid config file if preview provider is used  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6305 (7f0ae)
  • Correctly run in-source tests in the browser  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6440 (c8531)
  • Exclude missed packages from optimization, print help message  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6445 (8d883)
  • Define mocker as a dependency  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6476 (9560a)
• coverage:
  • Warn if vitest and @vitest/* versions don't match  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6317 (e662c)
  • V8 to support source maps with multiple sources  -  by @AriPerkkio and @sheremet-va in https://github.com/vitest-dev/vitest/issues/6120 (1f6cb)
  • V8 to warn instead of crash when conversion fails  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6318 (91dea)
  • Use project specific vitenode for uncovered files  -  by @AriPerkkio in https://github.com/vitest-dev/vitest/issues/6044 (da52d)
• runner:
  • Use performance.now instead of Date.now for duration  -  by @LuciNyan in https://github.com/vitest-dev/vitest/issues/6382 (fe489)
  • Async assertion auto await should timeout  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/6391 (ad6e7)
• snapshot:
  • Reject multiple toMatchInlineSnapshot updates at the same location  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/6332 (1606f)
  • Improve inline snapshot inside loop rejection  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/6339 (e0368)
• typecheck:
  • Run both runtime and typecheck tests if typecheck.include overlaps with include  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6256 (153ff)
• types:
  • Allow Callbacks Passed to before*/after* to Return Anything  -  by @LuciNyan in https://github.com/vitest-dev/vitest/issues/6393 (f6217)
• ui:
  • Remove "filters" flickering  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6463 (0223b)
  • Render project name consistently  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6329 (94a18)
• vite-node:
  • Disable watcher if hmr is disabled  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6251 (c51c6)
  • Fix watch on vite 6  -  by @hi-ogawa in https://github.com/vitest-dev/vitest/issues/6422 (c3ac4)
• vitest:
  • Update json reporter output  -  by @Emiyaaaaa in https://github.com/vitest-dev/vitest/issues/6064 (c9979)
  • Add more type guards for --merge-reports  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6307 (0a5d8)
  • Always resolve vitest to the root version  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6369 (163d7)
  • Dispose vmForks listeners to avoid memory leak  -  by @sheremet-va in https://github.com/vitest-dev/vitest/issues/6448 (2673c)

    View changes on GitHub