browser.instances

• Type: BrowserConfig
• Default: []

Defines multiple browser setups. Every config has to have at least a browser field.

You can specify most of the project options (not marked with a

icon) and some of the browser options like browser.testerHtmlPath.

WARNING

Every browser config inherits options from the root config:

vitest.config.ts

export default defineConfig({
  test: {
    setupFile: ['./root-setup-file.js'],
    browser: {
      enabled: true,
      testerHtmlPath: './custom-path.html',
      instances: [
        {
          // will have both setup files: "root" and "browser"
          setupFile: ['./browser-setup-file.js'],
          // implicitly has "testerHtmlPath" from the root config
          // testerHtmlPath: './custom-path.html',
        },
      ],
    },
  },
})

For more examples, refer to the "Multiple Setups" guide.

List of available browser options:

• browser (the name of the browser)
• headless
• locators
• viewport
• testerHtmlPath
• screenshotDirectory
• screenshotFailures
• provider

Under the hood, Vitest transforms these instances into separate test projects sharing a single Vite server for better caching performance.