DEV Community

Suzanne Aitchison
Suzanne Aitchison

Posted on • Updated on • Originally published at


Accessibility-First Integration Tests with React Testing Library

Often when we talk about accessibility testing we focus on either:

  • Browser extension linting tools (like Axe and Wave)
  • Manual testing, e.g. with screen readers

However it is possible to take an accessibility-focused approach in your integration tests too, and for React devs, React Testing Library is the perfect tool for the job.

"Hey, I use enzyme, what's the issue with it?"

Great question. Enzyme is a very popular library for integration testing in React. However, tests in enzyme replicate the developer's worldview, not the end user's.

Generally speaking, enzyme tests work by testing the implementation of a component, rather than the user experience. We assert that expected items are rendered by their parent, and that props are present and correct. We invoke callback functions directly and verify the expected updates in state, etc.

Testing the implementation like this has a few major downsides:

  1. Developer oversight is less likely to be caught - when we test our own implementation of a component, we are liable to repeat any assumptions or errors we made in that implementation

  2. We fail to test the path of user interaction completely. We may have checked that X many items are rendered on the screen, but we haven't truly checked that those items are perceivable and operable. Being Perceivable and Operable are two of the core requirements for an accessible app (find out more about POUR via this WebAim article: Constructing a POUR Website)

React Testing Library: Accessibility First

React Testing Library adopts a different mindset to enzyme, and it can be hard to adjust to when you first make the switch. The approach can be summed up as:

  • Test real interactions
  • Verify the perceivable results

Test high up the component tree

To truly focus on real user interactions, we should limit how much we test individual low-level components in isolation. Instead, we should ask ourselves:

How much of the page do I need to render to test a genuine set of user interactions?

For some apps, the answer might be the entire page. For others, it may only be a sub-section. Thinking about it visually can help: if you were to hand off your app to a colleague to manually test a given set of features - what section(s) of the page would you need them look at?

Queries that test items are perceivable

React Testing Library exposes several queries we can use to locate and verify rendered items, including: getByLabelText, getByAltText, and so on. They have a great FAQ on which query to use, ranking them in order of preference: Which query should I use?.

This is where the accessibility-first approach really shines.

Instead of querying the DOM by some property that can't be perceived by a user (e.g. classname), you instead use queries that will highlight gaps in your accessibility.

For example, getByLabelText is the preferred query for checking an input field. If you can't get a handle to your input field this way, a very important accessibility issue is brought to your attention via the testing process.

Actions that test items are operable

Once you have a handle to an element, you can use the fireEvent API to execute clicks and other user interactions. Although the fireEvent API doesn't exactly replicate the same user interaction (a neat explanation to this can be found in the docs: Interactions vs Events), it does allow us to verify that the element could be found, responds to a click event, and is therefore operable.

Instead of verifying click events by monitoring some internal state or prop change (as we might with enzyme), we can verify that the user has received the appropriate feedback from the event. For example, if an "add to basket" button has been clicked, we can verify that eventually the basket count icon has changed from '0' to '1', or that a message appears confirming "continue to checkout". We measure the success of an action by the perceivable results.


Overall, React Testing Library is designed to give our testing a user-centred worldview. Even better, its queries are designed to place accessibility at the heart of that worldview.

Have you made the switch from enzyme to React Testing Library? Let me know how you got on, or what you feel the trade-offs are. For me so far, it's been a big win 🙌

Did you find this post useful? Please consider buying me a coffee so I can keep making content 🙂

Top comments (2)

haakonhr profile image
Haakon Helmen Rusås

Really like your article! It is very important to get in the mindset of people instead of machine or code when you are testing your applications. PS. we are trying to incorporate this into our workflow now and your website has great info! Thanks!

s_aitchison profile image
Suzanne Aitchison

That's great to hear! Hope it goes well - would love to hear how you get on 🙂