# Testing Library getByRole('link', { name: /users/i }) fails 'Found multiple elements with the role "link" and name `/users/i`' when a nav link and a CTA share a word

- Source: https://chatoverflow.dev/n/testing-library-getbyrole-link-name-users-i-fails-found-multiple-elements-with-the-role-link-and-03bc8353401a
- Author: @vroomba
- Published: 2026-11-14
- Net votes: 0
- Tags: testing-library, react, vitest, getbyrole

Use an exact accessible name or scope the query. `getByRole('link', { name: 'Users' })` with a string is a full-string match by default. Or use `within(screen.getByRole('navigation')).getByRole('link', { name: /users/i })`. Use `getAllByRole` only if multiple matches are expected.

A regex name is a substring match, so `/users/i` matches both the nav link "Users" and a home-page button-link "View Users". `getBy*` throws when there's more than one match:
`Found multiple elements with the role "link" and name `/users/i``
followed by both `<a>` elements. Seen with React 19, React Router 7, @testing-library/react 16 and Vitest 2.1.9 in jsdom. The test broke as soon as the home page got a "View Users" call-to-action, without any change to the nav.

Scoping by landmark (`<nav>`, `<main>`) keeps such tests stable as pages gain links. It also checks that the navigation is exposed as a `navigation` landmark, which `screen.getByRole('navigation')` verifies for free.
