v14.0.0-rc.0

14.0.0-rc.0 (2026-05-07)

Migration guide

See the Migration to 14.x guide for
step-by-step upgrade instructions, codemods, and before/after examples.

Breaking changes

• Dropped support for React 18. React 19.0.0 or newer is now required.
• Raised the minimum supported React Native version to 0.78.
• Raised the minimum supported Node.js version to ^22.13.0 || >=24.
• Replaced the deprecated React Test Renderer with
  Test Renderer.
• Added a peer dependency on Test Renderer 1.x. Install the Test Renderer compatibility line
  that matches your React 19 minor version.
• Made the core rendering and event APIs async by default:
  • render() now returns Promise<RenderResult>.
  • renderHook() now returns Promise<RenderHookResult>.
  • fireEvent() and its helpers now return Promise<void>.
  • act() now always returns a Promise and should always be awaited.
• Removed the renderAsync, renderHookAsync, and fireEventAsync APIs. Use render,
  renderHook, and fireEvent instead.
• Removed the update alias. Use rerender instead.
• Removed the getQueriesForElement alias. Use within instead.
• Removed UNSAFE_root. Use container for the pseudo-element container or root for
  the first rendered host element.
• Removed legacy UNSAFE_* queries:
  • UNSAFE_getAllByType
  • UNSAFE_getByType
  • UNSAFE_getAllByProps
  • UNSAFE_getByProps
• Removed the concurrentRoot render and configuration option. Concurrent rendering is
  always enabled in v14.
• Removed the createNodeMock render option, which is not supported by the new Test Renderer
  integration.
• Removed the unstable_validateStringsRenderedWithinText render option. Text string
  validation is now always enabled.

Notable changes

• Reintroduced the container API as a safe pseudo-element container, aligned with React
  Testing Library semantics.
• Query results and the rendered element tree now expose host elements only. Composite
  components are no longer visible through the test tree.
• Type definitions now use TestInstance from Test Renderer instead of
  ReactTestInstance from React Test Renderer.
• Suspended or hidden instances are now represented with React Native-like hidden props, such
  as display: 'none', so visibility queries and matchers behave closer to runtime behavior.
• fireEvent.press() and fireEvent.scroll() now pass default synthetic native event objects
  to handlers and deep-merge any event props supplied by the test.
• Accessible name calculation now follows React Native inputs more closely, including
  TextInput placeholder handling, child accessible name concatenation, and stricter
  getByRole(..., { name }) matching.
• configure, render, renderHook, and userEvent.setup now warn when unknown options are
  passed, helping catch stale or misspelled options during migration.
• Text strings rendered outside of React Native <Text> components now throw, matching
  React Native runtime behavior.

Test Renderer versions

Install the Test Renderer version that matches your React 19 minor version:

React version	Recommended Test Renderer version
19.2	test-renderer@1.2
19.1	test-renderer@1.1
19.0	test-renderer@1.0

Older Test Renderer lines may not support newer React 19 features in tests. Newer Test
Renderer lines can produce peer dependency warnings, or an install error with npm. See the
Test Renderer React 19 compatibility lines
for the latest recommendations.

Codemods

Two codemods are available to automate the most common v14 upgrade work:

• rntl-v14-update-deps updates dependencies by removing React Test Renderer packages,
  adding Test Renderer, and updating React Native Testing Library.
• rntl-v14-async-functions updates test code for async render, renderHook, fireEvent,
  act, rerender, and unmount usage.

Full changelog

See the full GitHub comparison:
v13.3.3...v14.0.0-rc.0

v14.0.0-beta.1

14.0.0-beta.1 (2026-04-23)

✨ Features

• computeAccessibleName updates (#1879) (d47cd70)
• fireEvent.press/scroll default event object (#1884) (440668e)
• realistic instance hiding (#1898) (cd4f1ef)
• test-renderer 0.16 (#1893) (e3a3f68)

📚 Documentation

• common mistakes guide + llm guidelines (#1873) (a2024e9)
• readme-v13 reference (dc70923)
• simplify wording (#1871) (507f501)

v14.0.0-beta.0

14.0.0-beta.0 (2026-01-20)

Note

This is a beta release. APIs and behavior may change.

What's new

React 19 and React Native 0.78+

• Drops support for React 18.
• Requires React 19.0.0+ and React Native 0.78+.

Async APIs

The main APIs are now async to support React 19's async rendering (Suspense, use()):

• render, renderHook, fireEvent, and act return Promises and must be awaited.
• This flushes pending React updates before your assertions run.

New renderer

• Replaced deprecated react-test-renderer with Test Renderer.
• Improved DX (HostElement replaces ReactTestInstance).

container API

• screen.container is now safe to use.
• Returns a pseudo-element container wrapping the rendered elements.

Breaking changes

• Removed APIs: update (use rerender), getQueriesForElement (use within), UNSAFE_root (use container), and concurrentRoot option.
• Removed legacy queries: UNSAFE_getAllByType, UNSAFE_getByType, UNSAFE_getAllByProps, and UNSAFE_getByProps. Use standard queries like getByRole.
• Strict text validation: Text strings must be rendered within a <Text> component. The unstable_validateStringsRenderedWithinText option has been removed; validation is always on.

Migration

Use the codemods to upgrade:

1. Update dependencies:

   npx codemod@latest rntl-v14-update-deps --target .
   npm install

2. Migrate to async:

   npx codemod@latest rntl-v14-async-functions --target ./src

See the v14 Migration Guide for details.

Full Changelog

v14.0.0-alpha.6

14.0.0-alpha.6 (2026-01-09)

What's Changed

• v14 (alpha) - React 19 only, uses new renderer by @mdjastrzebski in #1705
• chore: unify nightly jobs by @mdjastrzebski in #1852
• chore: nightly CI for v13 by @mdjastrzebski in #1853
• chore: test-renderer 0.13 by @mdjastrzebski in #1854
• refactor: remove unsafe sync functions by @mdjastrzebski in #1855
• refactor: remove deprecated aliases: update and getQueriesForElement by @mdjastrzebski in #1856
• chore: rewrite render tests by @mdjastrzebski in #1859

Full Changelog: v14.0.0-alpha.5...v14.0.0-alpha.6

v14.0.0-alpha.5

14.0.0-alpha.5 (2026-01-06)

• renaming:
  • renderAsync => render, render => unsafe_renderSync
  • renderHookAsync => renderHook, renderHook => unsafe_renderHookSync
  • fireEventAsync => fireEvent, fireEvent => unsafe_fireEventSync
  • actAsync => act, act => unsafe_act

v14.0.0-alpha.4

14.0.0-alpha.4 (2026-01-04)

• make renderHook async by default

v14.0.0-alpha.3

14.0.0-alpha.3 (2026-01-02)

• improved toJSON output

v14.0.0-alpha.2

14.0.0-alpha.2 (2026-01-02)

v14 is back:

• rebased, to latest v13
• proper fireEvent support with new unstable_fiber api from UTR
• some rough edges still remain (it's alpha)

v13.3.3

13.3.3 (2025-08-26)

🐛 Bug Fixes

• use cleanupAsync (#1817) (c419a70)
• improve error message in toHaveStyles (#1819) (9d89ea9)

v13.3.2

13.3.2 (2025-08-25)

🐛 Bug Fixes

• Do not infer generic Props type from RenderHookOptions (#1816) (919f7c6)

New Contributors

• @AlterNT made their first contribution in #1816