chore: allow exact in cli

sheremet-va · sheremet-va · commit 5503d59f1a79 · 2026-03-28T13:30:00.000+01:00
diff --git a/docs/guide/cli-generated.md b/docs/guide/cli-generated.md
@@ -429,6 +429,13 @@ Control if Vitest catches uncaught exceptions so they can be reported (default:
 
 Enable trace view mode. Supported: "on", "off", "on-first-retry", "on-all-retries", "retain-on-failure".
 
+### browser.locators.exact
+
+- **CLI:** `--browser.locators.exact`
+- **Config:** [browser.locators.exact](/config/browser/locators#locators-exact)
+
+Should locators match the text exactly by default (default: `false`)
+
 ### pool
 
 - **CLI:** `--pool <pool>`
diff --git a/packages/vitest/src/node/cli/cli-config.ts b/packages/vitest/src/node/cli/cli-config.ts
@@ -418,7 +418,22 @@ export const cliOptionsConfig: VitestCLIOptions = {
       viewport: null,
       screenshotDirectory: null,
       screenshotFailures: null,
-      locators: null,
+      locators: {
+        description: 'Options for how locators should be handled by default',
+        argument: '<options>',
+        subcommands: {
+          testIdAttribute: null,
+          exact: {
+            description: 'Should locators match the text exactly by default (default: `false`)',
+          },
+        },
+        transform(val) {
+          if (typeof val !== 'object' || val == null) {
+            return {}
+          }
+          return val
+        },
+      },
       testerHtmlPath: null,
       instances: null,
       expect: null,
diff --git a/test/core/test/cli-test.test.ts b/test/core/test/cli-test.test.ts
@@ -289,6 +289,15 @@ test('browser.detailsPanelPosition is parsed correctly', () => {
   })
 })
 
+test('browser.locators are passed correctly', () => {
+  expect(getCLIOptions('--browser.locators')).toEqual({
+    browser: { locators: {} },
+  })
+  expect(getCLIOptions('--browser.locators.exact')).toEqual({
+    browser: { locators: { exact: true } },
+  })
+})
+
 test('clearScreen', async (ctx) => {
   // skip vm since rolldown native modules break due to RegExp instance
   // https://github.com/vitest-dev/vitest/issues/8754#issuecomment-3727583957
