RNTL v13 & v14 roadmap

[mdjastrzebski]

I wanted to share some details about future plans for the React Native Testing Library, especially in the context of the React Test Renderer (RTR) being deprecated. We plan to replace RTR with a new test renderer, for which I’ve already built a prototype that validated this approach.

Here is the RNTL major release roadmap:

• v12 (current version)
• Supports React 16, 17, & 18
• Might work with React 19 (not a goal)
• v13 (Q4 2024)
  • Supports React 18 & 19 only, drops support for 16 & 17
  • Uses React Test Renderer
  • Drops deprecated features (*ByA11State, *ByA11Queries, etc.)
  • Relatively smooth migration
• v14 (H1 2025)
  • Supports React 19+
  • Uses new test renderer
  • Changes around Fire Event API event handling that might break some code

There is no urgency in replacing RTR as it’s still present in React 19, although with some deprecation warnings.

The new test renderer will operate only on host components. In general, this is the desired state, as we already limit RNTL to this. One area where this will impact users is the ability to directly call event handlers on composite components using the Fire Event API. Current RNTL allows this for legacy test reasons, but it will no longer be possible with the new renderer. We will provide an easy migration to v14 for common events like press though.

[mdjastrzebski]

CC: @thymikee @pierrezimmermannbam @MattAgn @AugustinLF

[pierrezimmermannbam]

This sounds like a good plan!

Regarding V13, you already did pretty much everything right? Besides reviewing and merging #1607 and waiting for RN 0.77 there is nothing else to do, correct?

[pierrezimmermannbam]

Regarding the focus management it's not really clear to me what tracking focus with native state would enable, do you have some examples?

I very much agree that solving the issue with refs would be a very good improvement to RN and it should probably done no matter what we do on focus management

[mdjastrzebski]

@pierrezimmermannbam send more info on the failing tests, is it v13 or v14 failing? How does it compare to v12 with concurrentRoot option set to true?

[mdjastrzebski]

re focus tracking: that would be rather marginal update, and leveling-up how RTL/Jest DOM works. We could maintain WebAPI-like activeElement, probably as screen.activeElement or similar. That way we could track the current active element, whether change came with default event behavior or from user components calling ref.focus() in event handlers / effects. Then we could have reliably implement toHaveFocus() matcher and enable users testing focus state.

[pierrezimmermannbam]

I'm testing v13-alpha right now, the issues come from concurrentRoot option, if I disable it then it works fine. There are some subtle differences in how suspense works it seems. I managed to fix most of my issues but now I have flaky tests, I need to investigate more to understand what the problem is but it's not related to RNTL probably. I'll try the beta then

[mdjastrzebski]

@pierrezimmermannbam I've released v14-alpha using new test renderer that I've wrote (universal-test-renderer). It might be somewhat more difficult to check your tests against it. But I am curious about any feedback. This is not urgent, as v13 is still going to happen earlier.
Edit: currently it requires React 19, which might actually prevent you from testing it, util RN 0.77 comes which should use R19.

[ntucker]

Is this supposed to be compatible with react 19 and react-test-renderer@19? I'm using react-native@0.78.0-nightly-20250108-ec72af403, which is the first one that lists react 19 as a peerDep, and I'm getting an error when using renderHook:

Can't access .root on unmounted test renderer

This works when using RN@77 and react@18.3 and @testing-library/react-native@13

[mdjastrzebski]

@ntucker v13 should work with React 19. We have a PR for testing that RNTL works with React 19 + RN nightly: #1723

Could you provide a minimal reproduction repo so I could investigate your issue?