title: browser.enabled | Config #

browser.enabled #

• Type: boolean
• Default: false
• CLI: --browser, --browser.enabled=false

Enabling this flag makes Vitest run all tests in a browser by default. If you are configuring other browser options via the CLI, you can use --browser.enabled alongside them instead of --browser:

vitest --browser.enabled --browser.headless

::: warning To enable Browser Mode, you must also specify the provider and at least one instance. Available providers:

• playwright
• webdriverio
• preview

:::

Example #

import { defineConfig } from 'vitest/config'
import { playwright } from '@vitest/browser-playwright'

export default defineConfig({
  test: {
    browser: {
      enabled: true,
      provider: playwright(),
      instances: [
        { browser: 'chromium' },
      ],
    },
  },
})

If you use TypeScript, the browser field in instances provides autocompletion based on your provider.