Skip to content
masterclass Buddy
Start learning

React Testing Library · Module

queryAllByRole

ByRole queries find elements by their ARIA role, including native HTML roles, with optional accessible-name and state filters. Choose get, query, or find variants based on whether absence should throw and whether the DOM changes asynchronously.

Last updated

Syntax

getByRole(container: HTMLElement, role: string, options?: { hidden?: boolean; name?: TextMatch; description?: TextMatch; selected?: boolean; busy?: boolean; checked?: boolean; pressed?: boolean; suggest?: boolean; current?: boolean | string; expanded?: boolean; queryFallbacks?: boolean; level?: number; value?: { min?: number; max?: number; now?: number; text?: TextMatch } }): HTMLElement

In-depth API docs are only for subscribers: parameters, examples, common mistakes and interview practice.

Subscribe
  • getByRole
  • queryByRole
  • getAllByRole
  • queryAllByRole
  • findByRole
  • findAllByRole
  • screen
  • within

Source: ByRole | Testing Library. Checked 2026-11-03.