Repolode
Enviar
testing-library

testing-library/react-testing-library

Utilitários leves para testar o DOM do React, consultando e interagindo com componentes como os usuários fazem.

Ver no GitHubSite
Estrelas
19,672
Forks
1,171
Issues abertas
84
Último commit
há 2 meses

O que é?

React Testing Library oferece funções utilitárias, construídas sobre react-dom e react-dom/test-utils, para testar componentes React. Sua ideia central é que os testes devem se parecer com a forma como o software é usado. Por isso, a biblioteca se concentra nos nós do DOM, em vez de instâncias de componentes, e evita expor detalhes de implementação.

A biblioteca oferece render, consultas de screen como getByRole, getByLabelText e getByText, além de fireEvent para simular interações do usuário. As consultas com os prefixos get, query e find abrangem os casos comuns de esperar que um elemento exista, verificar que ele não está presente ou aguardar até que apareça. A partir da versão 16, @testing-library/dom é uma peer dependency; as versões 13 em diante exigem React 18.

É comum usar a biblioteca com Jest ou outros test runners. Ela também funciona bem com @testing-library/jest-dom para asserções no DOM e com Mock Service Worker para simular chamadas de API. Existe uma React Hooks Testing Library separada para hooks customizados reutilizáveis.

Recursos principais

  • 01Consulta elementos por funções acessíveis, rótulos e texto, refletindo como os usuários os encontram.
  • 02Oferece os auxiliares render e fireEvent para montar componentes e simular interações.
  • 03Inclui os utilitários assíncronos find e waitFor para atualizações da UI.
  • 04Funciona com Jest e outros test runners, sobre react-dom.
  • 05Combina com os matchers de jest-dom para asserções legíveis no DOM.

Casos de uso

  • Escrever testes unitários ou de integração para componentes React que continuem estáveis durante refatorações.
  • Testar formulários, fluxos de uso e renderização condicional em aplicações React.
  • Verificar comportamentos assíncronos da UI, como estados de carregamento e dados obtidos.

Início rápido

  1. 1

    Instale React Testing Library e DOM testing utilities como dependências de desenvolvimento usando npm

    npm install --save-dev @testing-library/react @testing-library/dom
  2. 2

    Ou instale-as com yarn

    yarn add --dev @testing-library/react @testing-library/dom
  3. 3

    Escreva um teste que renderize um componente e consulte elementos como os usuários fazem, usando render e screen da biblioteca

Antes de usar

  • A partir da versão 16, é necessário instalar @testing-library/dom separadamente.
  • As versões 13 e posteriores exigem React 18; projetos com versões anteriores do React devem usar a versão 12.

Tópicos

#react#testing#javascript#unit-testing#frontend-testing#jest#dom#reactjs

Perguntas frequentes

O que é react-testing-library?
Utilitários leves para testar o DOM do React, consultando e interagindo com componentes como os usuários fazem. React Testing Library oferece funções utilitárias, construídas sobre react-dom e react-dom/test-utils, para testar componentes React. Sua ideia central é que os testes devem se parecer com a forma como o software é usado. Por isso, a biblioteca se concentra nos nós do DOM, em vez de instâncias de componentes, e evita expor detalhes de implementação.
react-testing-library é gratuito? Qual é a licença?
react-testing-library é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
react-testing-library ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de react-testing-library foi em 27 de ago. de 2026.
Para que posso usar react-testing-library?
Escrever testes unitários ou de integração para componentes React que continuem estáveis durante refatorações. Testar formulários, fluxos de uso e renderização condicional em aplicações React. Verificar comportamentos assíncronos da UI, como estados de carregamento e dados obtidos.
Como instalar react-testing-library?
Instale React Testing Library e DOM testing utilities como dependências de desenvolvimento usando npm: npm install --save-dev @testing-library/react @testing-library/dom Ou instale-as com yarn: yarn add --dev @testing-library/react @testing-library/dom Escreva um teste que renderize um componente e consulte elementos como os usuários fazem, usando render e screen da biblioteca
Onde consigo react-testing-library?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/testing-library/react-testing-library

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados