react-testing-library

Prefer role- and label-based accessibility queries over implementation details to write maintainable React Testing Library tests. This verifies user-observable behavior and keeps tests resilient to internal component refactoring.

Use findBy queries for asynchronously appearing elements and await userEvent for interactions to handle async rendering in React component tests. Keep waitFor focused on specific assertions to prevent flaky tests and avoid empty callbacks.

Unnecessary act warnings in React Testing Library occur from manual state updates or incorrect async handling. Use findBy queries and await userEvent async semantics to let the library handle updates, preventing unnecessary act wrappers.

Avoid container.querySelector in React Testing Library as it bypasses the accessibility tree and tests implementation details. Use role- and label-based queries like getByRole to verify user-visible behavior and ensure components are accessible.

React Testing Library applies across Jest and Vitest-style setups. It works seamlessly with jest-dom matchers to assert user-observable behavior and accessibility, enabling structured Arrange-Act-Assert tests that diagnose failures quickly.