fix: forbid setting environment to browser (#8334)

sheremet-va · web-flow · commit 0417a2c1af3c · 2025-07-22T17:59:01.000+02:00
diff --git a/packages/vitest/src/node/config/resolveConfig.ts b/packages/vitest/src/node/config/resolveConfig.ts
@@ -153,6 +153,10 @@ export function resolveConfig(
 
   resolved.color = typeof options.name !== 'string' ? options.name?.color : undefined
 
+  if (resolved.environment === 'browser') {
+    throw new Error(`Looks like you set "test.environment" to "browser". To enabled Browser Mode, use "test.browser.enabled" instead.`)
+  }
+
   const inspector = resolved.inspect || resolved.inspectBrk
 
   resolved.inspector = {
diff --git a/test/config/test/failures.test.ts b/test/config/test/failures.test.ts
@@ -604,3 +604,10 @@ test('cannot set the `workspace` options', async () => {
   })
   expect(stderr).toContain('The `test.workspace` option was removed in Vitest 4. Please, migrate to `test.projects` instead. See https://vitest.dev/guide/projects for examples.')
 })
+
+test('cannot set environment: browser', async () => {
+  const { stderr } = await runVitest({
+    environment: 'browser',
+  })
+  expect(stderr).toContain('Looks like you set "test.environment" to "browser". To enabled Browser Mode, use "test.browser.enabled" instead.')
+})
