Skip to content
masterclass Buddy
Start learning

React Testing Library · Module

findAllByRole

Use ByRole queries to find elements by their ARIA role and accessible properties. Native HTML semantics supply default roles, so explicit roles are often unnecessary.

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
  • within
  • user-event

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