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

v13.3.1

13.3.1 (2025-08-20)

🐛 Bug Fixes

• fix render hook typing (#1811) (97280b0)

v13.3.0

13.3.0 (2025-08-18)

✨ Features

• React Suspense support (renderAsync) (#1788) (79d230a)
• renderHookAsync (#1805) (196680b)

📚 Documentation

• React 19/Suspense docs (#1806) (830af58)