Repolode
testcontainers

testcontainers/testcontainers-java

Biblioteca Java para testes com JUnit que inicia containers Docker descartáveis para bancos de dados, navegadores Selenium e outros serviços.

Estrelas
8,759
Forks
1,950
Issues abertas
638
Último commit
há 5 dias

O que é?

Testcontainers permite que testes em Java sejam executados com infraestrutura real, em vez de mocks. Os testes iniciam containers Docker leves e temporários para bancos de dados, navegadores Selenium ou qualquer outro serviço que possa rodar em um container; ao fim dos testes, os containers são descartados.

A biblioteca se integra ao JUnit, vinculando o ciclo de vida dos containers às classes e aos métodos de teste. O projeto também oferece módulos prontos para bancos de dados e serviços comuns, e a mesma abordagem funciona com qualquer imagem que possa ser executada no Docker.

A biblioteca exige um ambiente Docker funcional, e a documentação está hospedada em java.testcontainers.org.

Recursos principais

  • 01Inicia containers Docker descartáveis para os testes e os remove ao final.
  • 02Integra-se aos ciclos de vida dos testes do JUnit.
  • 03Oferece suporte pronto para bancos de dados comuns e navegadores Selenium.
  • 04Funciona com qualquer serviço que possa rodar em um container Docker.

Casos de uso

  • Executar testes de integração com um banco de dados real, em vez de uma alternativa em memória.
  • Testar fluxos de interface baseados em navegador com Selenium em um ambiente conteinerizado.
  • Iniciar brokers de mensagens ou outras dependências necessárias à suíte de testes de um serviço Java.

Início rápido

  1. 1

    Consulte a documentação para ver as instruções de configuração

Antes de usar

  • Para executar os testes, é necessário um ambiente com o Docker (ou um runtime de contêiner compatível) em execução.

Em coleções

Tópicos

Perguntas frequentes

O que é testcontainers-java?
Biblioteca Java para testes com JUnit que inicia containers Docker descartáveis para bancos de dados, navegadores Selenium e outros serviços. Testcontainers permite que testes em Java sejam executados com infraestrutura real, em vez de mocks. Os testes iniciam containers Docker leves e temporários para bancos de dados, navegadores Selenium ou qualquer outro serviço que possa rodar em um container; ao fim dos testes, os containers são descartados.
testcontainers-java é gratuito? Qual é a licença?
testcontainers-java é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
testcontainers-java ainda é mantido?
Manutenção ativa. O último commit de testcontainers-java foi em 2 de nov. de 2026.
Para que posso usar testcontainers-java?
Executar testes de integração com um banco de dados real, em vez de uma alternativa em memória. Testar fluxos de interface baseados em navegador com Selenium em um ambiente conteinerizado. Iniciar brokers de mensagens ou outras dependências necessárias à suíte de testes de um serviço Java.
Como instalar testcontainers-java?
Consulte a documentação para ver as instruções de configuração
Onde consigo testcontainers-java?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/testcontainers/testcontainers-java

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

Projetos relacionados