NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1021 most downloaded on npm
Simple and complete React DOM testing utilities that encourage good testing practices.
Latest stable
16.3.3
Last release 2 months ago
27 Aug 2026
Release timing varies
gaps range from 8 days to 9 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
123 releases · first in 2019
Drag across the ruler to compare, or tap a release to open it.
Avoid act() re-entrant when dispatching events
Update 'onCaughtError' type inference in 'RenderOptions' to work with React v19
Your coding agent can read these notes before it upgrades. Set up the MCP server →
## 16.3.1 (2025-12-15) ### Bug Fixes * Switch to trusted publishing
add bernardobelchior as a contributor for code, and doc
Add support for React error handlers
# 16.1.0 (2024-12-05) ### Features * Add support for React 19
Add support for exactOptionalPropertyTypes in TypeScript
Move @testing-library/dom and @types/react-dom to peer dependencies
@testing-library/dom was moved to a peer dependency and needs to be explicitly installed. This reduces the chance of having conflicting versions of @testing-library/dom installed that frequently caused bugs when used with @testing-library/user-event. We will also be able to allow new versions of @testing-library/dom being used without a SemVer major release of @testing-library/react by just widening the peer dependency.
@types/react-dom needs to be installed if you're typechecking files using @testing-library/react.Ensure act is not any when React.act is not declared
## 15.0.6 (2024-05-01) ### Bug Fixes * export new act when available
Stop restricting container option based on hydrate
Ensure renderHook options extend options for render
Don't raise TypeScript errors when hydating document
Improve legacyRoot error message
## 15.0.1 (2024-04-11) ### Bug Fixes * Stop using nullish coalescing
Minimum supported Node.js version is 18.0
@testing-library/dom changes various roles. Check out the changed tests in https://github.com/testing-library/dom-testing-library/commit/2c570553d8f31b008451398152a9bd30bce362b3 to get an overview about what changed.## 14.3.1 (2024-04-11) ### Bug Fixes * Stop using nullish coalescing
Add support for React 19 Canary
## 14.2.2 (2024-03-19) ### Bug Fixes * Remove unused types
Update types to support all possible react component return values
add reactStrictMode option to enable strict mode render
## 14.1.2 (2023-11-17) ### Bug Fixes * revert missing hooks warnings
log globals warning only once (#1252) (fd52a59), closes #1249
add warnings when globals are missing
Prevent "missing act" warning for queued microtasks
Prevent "missing act" warning for queued microtasks
Bump @testing-library/dom to 9.0.0
Minimum supported Node.js version is now 14.x
Minimum supported Node.js version is now 14.x
renderHook: allow passing of all render options to renderHook
# 13.3.0 (2022-05-28) ### Features * Use globalThis if available
# 13.2.0 (2022-05-03) ### Features * Export RenderHookOptions type
TS: export interface RenderHookResult
# 13.1.0 (2022-04-15) ### Features * Add renderHook
Specify a non-* version for @types/react-dom
To opt-out of this change you can use render(ui, { legacyRoot: true } ). But be aware that the legacy root API is deprecated in React 18 and its usage…
createRoot API by default which comes with a set of changes while also enabling support for concurrent features.
To opt-out of this change you can use render(ui, { legacyRoot: true } ). But be aware that the legacy root API is deprecated in React 18 and its usage will trigger console warnings.Add @types/react-dom as a direct dependency
@types/react-dom as a direct dependency (#1001) (149d9a9)Resolve warning using the wrong react-dom entrypoint
Enable "missing act" warnings in React 18 by default
render: Actually hydrate with given ui
Empty commit to force semantic-release
To can opt-out of this change by using render(ui, { legacyRoot: true } ). But be aware that the legacy root API is deprecated in React 18 and its usag…
createRoot API by default which comes with a set of changes while also enabling support for concurrent features.
To can opt-out of this change by using render(ui, { legacyRoot: true } ). But be aware that the legacy root API is deprecated in React 18 and its usage will trigger console warnings.## 12.1.5 (2022-04-11) ### Bug Fixes * Only supports React < 18
Match runtime type of baseElement in TypeScript types
Add @types/react-dom as a direct dependency
render: Don't reject wrapper types based on statics
TS: make wrapper allow a simple function comp
improve JSDocs for RenderOptions
Bump @testing-library/dom to 8.0.0. Please check out the `@testing-library/dom@8.0.0` release page for a detailed list of breaking changes.
@testing-library/dom to 8.0.0. Please check out the @testing-library/dom@8.0.0 release page for a detailed list of breaking changes.# 12.0.0-alpha.2 (2021-06-13) ### Bug Fixes * Update @testing-library/dom
node 10 is no longer supported. It reached its end-of-life on 30.04.2021.
Bump testing-library/dom to v8 alpha
Guard against process not being defined
types: exclude tsconfig from types folder in publish flow
render: add default type for Queries parameter
render: Default to HTMLElement in returned container
## 11.2.3 (2021-01-07) ### Bug Fixes * Return type of unmount is void
dependencies: bump dom testing library
types: Allow all HTML and SVG elements in render.
# 11.2.0 (2020-11-18) ### Features * bump dom testing library
One column per quarter.