vitest-dev
diff --git a/‎docs/api/browser/locators.md‎
Lines changed: 1 addition & 1 deletion b/‎docs/api/browser/locators.md‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎packages/browser/context.d.ts‎
Lines changed: 4 additions & 1 deletion b/‎packages/browser/context.d.ts‎
Lines changed: 4 additions & 1 deletion
diff --git a/‎packages/browser/src/client/tester/locators.ts‎
Lines changed: 2 additions & 1 deletion b/‎packages/browser/src/client/tester/locators.ts‎
Lines changed: 2 additions & 1 deletion
diff --git a/‎packages/ui/client/components/artifacts/visual-regression/VisualRegressionSlider.spec.ts‎
Lines changed: 2 additions & 4 deletions b/‎packages/ui/client/components/artifacts/visual-regression/VisualRegressionSlider.spec.ts‎
Lines changed: 2 additions & 4 deletions
diff --git a/‎test/browser/test/locators.test-d.ts‎
Lines changed: 11 additions & 0 deletions b/‎test/browser/test/locators.test-d.ts‎
Lines changed: 11 additions & 0 deletions
@@ -515,7 +515,7 @@ page.getByRole('button')
 ## filter
 
 ```ts
-function filter(options: LocatorOptions): Locator
+function filter(options: LocatorFilterOptions): Locator
 ```
 
 This methods narrows down the locator according to the options, such as filtering by text. It can be chained to apply multiple filters.
 
@@ -447,6 +447,9 @@ export interface LocatorOptions {
    * regular expression. Note that exact match still trims whitespace.
    */
   exact?: boolean
+}
+
+export interface LocatorFilterOptions {
   hasText?: string | RegExp
   hasNotText?: string | RegExp
   has?: Locator
@@ -766,7 +769,7 @@ export interface Locator extends LocatorSelectors {
    * Narrows existing locator according to the options.
    * @see {@link https://vitest.dev/api/browser/locators#filter}
    */
-  filter(options: LocatorOptions): Locator
+  filter(options: LocatorFilterOptions): Locator
   /**
    * This method returns an element matching the locator.
    * Unlike [`.element()`](https://vitest.dev/api/browser/locators#element),
 
@@ -1,6 +1,7 @@
 import type { ParsedSelector } from 'ivya'
 import type {
   LocatorByRoleOptions,
+  LocatorFilterOptions,
   LocatorOptions,
   LocatorScreenshotOptions,
   MarkOptions,
@@ -273,7 +274,7 @@ export abstract class Locator {
     return this.locator(getByTitleSelector(title, options))
   }
 
-  public filter(filter: LocatorOptions): Locator {
+  public filter(filter: LocatorFilterOptions): Locator {
     const selectors = []
 
     if (filter?.hasText) {
 
@@ -76,10 +76,8 @@ describe('VisualRegressionSlider', () => {
 
     const container = page.getByLabelText(containerLabel)
     const input = page.getByLabelText(inputLabel)
-    const status = page.getByRole(
-      'status',
-      { hasText: 'Showing 50% reference, 50% actual' },
-    )
+    const status = page.getByRole('status')
+      .filter({ hasText: 'Showing 50% reference, 50% actual' })
 
     // container with accessible label should exist and contain input and status
     await expect.element(container).toBeInTheDocument()
 
@@ -0,0 +1,11 @@
+import { test } from 'vitest'
+import { page } from 'vitest/browser'
+
+test('filter options are not accepted by getBy* methods', () => {
+  // @ts-expect-error -- `hasText` is only supported by `.filter()`
+  page.getByRole('button', { hasText: 'A' })
+  // @ts-expect-error -- `hasText` is only supported by `.filter()`
+  page.getByText('hello', { hasText: 'A' })
+
+  page.getByRole('button').filter({ hasText: 'A' })
+})