Skip to content
masterclass Buddy
Start learning

React Testing Library · Module

getAllByRole

ByRole queries find elements by their ARIA role, including roles provided by semantic HTML. Options can narrow the result by accessible name, state, heading level, visibility, or range value.

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
  • queryByRole
  • getAllByRole
  • queryAllByRole
  • findByRole
  • findAllByRole
  • screen
  • within

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