Skip to content

Lupa API Reference / commands/locator / QueryByRole

Interface: QueryByRole

Defined in: src/commands/locator.ts:9

The role locator reflects how users and assistive technology perceive the page, for example whether some element is a button or a checkbox. When locating by role, you should usually pass the accessible name as well, so that the locator pinpoints the exact element.

Properties

role

role: string

Defined in: src/commands/locator.ts:14

The role to use to locate the element. Only values from the WAI-ARIA Roles list are allowed.