Una biblioteca CSS-in-JS flexible y de alto rendimiento para dar estilo a aplicaciones con estilos en formato de cadena u objeto y una composición predecible.
18 mil1,1 milJavaScriptMITActualizado hace 2 meses
testing-library/react-testing-library
Utilidades ligeras para probar el DOM de React, consultar componentes e interactuar con ellos como lo harían los usuarios.
- Estrellas
- 19,672
- Forks
- 1,171
- Issues abiertos
- 84
- Último commit
- hace 2 meses
¿Qué es?
React Testing Library ofrece funciones de utilidad basadas en react-dom y react-dom/test-utils para probar componentes de React. Su principio es que las pruebas deben parecerse a la forma en que se usa el software, por lo que la biblioteca se centra en los nodos del DOM en lugar de las instancias de los componentes y evita exponer detalles de implementación.
La biblioteca ofrece render, consultas de screen como getByRole, getByLabelText y getByText, y fireEvent para simular interacciones de usuario. Las consultas con los prefijos get, query y find cubren los casos habituales: esperar que un elemento exista, comprobar que no esté presente o esperar a que aparezca. Desde la versión 16, requiere @testing-library/dom como dependencia peer, y las versiones 13 y posteriores requieren React 18.
Se suele usar con Jest u otros ejecutores de pruebas, y se complementa bien con @testing-library/jest-dom para hacer aserciones sobre el DOM y con Mock Service Worker para simular llamadas a API. También existe una biblioteca independiente, React Hooks Testing Library, para hooks personalizados reutilizables.
Funciones clave
- 01Busca elementos por roles accesibles, etiquetas y texto, de forma similar a como los encuentran los usuarios.
- 02Ofrece las funciones auxiliares render y fireEvent para montar componentes y simular interacciones.
- 03Incluye las utilidades asíncronas find y waitFor para las actualizaciones de la interfaz de usuario.
- 04Funciona con Jest y otros ejecutores de pruebas sobre react-dom.
- 05Se complementa con los matchers de jest-dom para escribir aserciones legibles sobre el DOM.
Casos de uso
- Escribir pruebas unitarias o de integración para componentes de React que sigan siendo estables tras refactorizar el código.
- Probar formularios, flujos de usuario y renderizado condicional en aplicaciones React.
- Verificar comportamientos asíncronos de la interfaz, como estados de carga y datos obtenidos.
Inicio rápido
- 1
Instala React Testing Library y DOM testing utilities como dependencias de desarrollo con npm
npm install --save-dev @testing-library/react @testing-library/dom - 2
También puedes instalarlas con yarn
yarn add --dev @testing-library/react @testing-library/dom - 3
Escribe una prueba que renderice un componente y lo consulte como lo harían los usuarios, usando render y screen de la biblioteca
Antes de usarlo
- A partir de la versión 16, es necesario instalar @testing-library/dom por separado.
- Las versiones 13 y posteriores requieren React 18; los proyectos con versiones anteriores de React deben usar la versión 12.
Temas
Preguntas frecuentes
- ¿Qué es react-testing-library?
- Utilidades ligeras para probar el DOM de React, consultar componentes e interactuar con ellos como lo harían los usuarios. React Testing Library ofrece funciones de utilidad basadas en react-dom y react-dom/test-utils para probar componentes de React. Su principio es que las pruebas deben parecerse a la forma en que se usa el software, por lo que la biblioteca se centra en los nodos del DOM en lugar de las instancias de los componentes y evita exponer detalles de implementación.
- ¿react-testing-library es gratuito? ¿Qué licencia tiene?
- react-testing-library es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿react-testing-library sigue mantenido?
- Actualizado en los últimos 6 meses. El último commit de react-testing-library fue el 27 ago 2026.
- ¿Para qué puedo usar react-testing-library?
- Escribir pruebas unitarias o de integración para componentes de React que sigan siendo estables tras refactorizar el código. Probar formularios, flujos de usuario y renderizado condicional en aplicaciones React. Verificar comportamientos asíncronos de la interfaz, como estados de carga y datos obtenidos.
- ¿Cómo se instala react-testing-library?
- Instala React Testing Library y DOM testing utilities como dependencias de desarrollo con npm: npm install --save-dev @testing-library/react @testing-library/dom También puedes instalarlas con yarn: yarn add --dev @testing-library/react @testing-library/dom Escribe una prueba que renderice un componente y lo consulte como lo harían los usuarios, usando render y screen de la biblioteca
- ¿Dónde consigo react-testing-library?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/testing-library/react-testing-library
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Una biblioteca de JavaScript para crear interfaces de usuario interactivas con componentes componibles, disponible para la web, el servidor y plataformas nativas.
251,6 mil51,6 milJavaScriptMITActualizado hace 9 horas
Framework para crear aplicaciones nativas de Android e iOS con React, cuya interfaz en JavaScript se renderiza con componentes nativos de cada plataforma.
126,7 mil25,4 milC++MITActualizado hace 6 horas
Editor de texto enriquecido sin interfaz y agnóstico al framework, basado en ProseMirror y ampliable con un amplio conjunto de extensiones.
38,8 mil3,2 milTypeScriptMITActualizado hace 11 horas
Bibliotecas open source para React y Svelte con las que crear interfaces interactivas basadas en nodos, como diagramas de flujo, grafos y editores de workflows.
38,7 mil2,6 milTypeScriptMITActualizado hace 17 horas
Solución abierta y multiplataforma para crear una sola app con React o Vue que funcione en miniprogramas de WeChat, Alipay y otras plataformas, en la web H5 y en React Native.
37,7 mil4,9 milTypeScriptOtherActualizado hace 24 horas