Checklist de testes de e-mail para desenvolvedores: da solicitação à expiração

Um teste de e-mail confiável não termina quando “alguma mensagem apareceu”. Ele precisa demonstrar que a solicitação correta gerou a mensagem correta, para o destinatário correto, dentro de um limite de tempo conhecido, e que os dados foram removidos ao final.

Prepare um caso isolado

Use uma caixa por execução ou por caso independente. Não reutilize uma caixa compartilhada em jobs paralelos. Gere dados sintéticos e nunca envie senha real, documento pessoal ou informação de cliente para um ambiente de teste.

Registre um identificador de correlação seguro no sistema em teste e, se possível, no assunto ou em um cabeçalho não sensível. Defina horário inicial UTC, tempo máximo e condição explícita de sucesso.

Verifique solicitação e transporte

Confirme a resposta da aplicação: status, evento criado e destinatário. Depois consulte a caixa com intervalo crescente e limite total. Esperas fixas curtas produzem falhas intermitentes; consultas agressivas criam carga e podem acionar limites.

Ao receber a mensagem, compare destinatário, tipo de evento, identificador e horário. Não selecione apenas “o e-mail mais recente”, pois outra execução pode ter criado uma mensagem semelhante.

Revise conteúdo e apresentação

Valide assunto, remetente visível, versão em texto simples, HTML e idioma. Confirme que variáveis obrigatórias foram substituídas e que dados de outra pessoa não aparecem. Teste texto longo, caracteres acentuados, modo escuro e largura móvel.

Links devem usar HTTPS, domínio esperado e parâmetros corretos. Não registre o token completo. Para anexos, verifique nome, tipo declarado, tamanho e comportamento quando ausente ou acima do limite. O orçamento local de anexos ajuda a estimar crescimento por Base64 e MIME.

Acessibilidade e segurança

O conteúdo precisa manter ordem de leitura, títulos coerentes, texto alternativo útil e links compreensíveis fora do contexto. Imagens não devem ser o único meio de transmitir um código ou instrução.

Confira SPF, DKIM e DMARC como evidência de autenticação, sem tratá-los como análise de conteúdo. Garanta que links e códigos tenham expiração e que uma nova solicitação invalide o segredo anterior quando esse for o contrato.

Expiração, erro e limpeza

Teste mensagem atrasada, duplicada, ausente e fora de ordem. Verifique o comportamento depois que código e caixa expiram. A aplicação deve apresentar erro compreensível sem revelar segredo ou estado interno desnecessário.

No finally do teste, exclua a caixa e remova artefatos. Guarde apenas resultado, horário, identificador redigido e versão do sistema. A orientação sobre evidências detalha o que não deve ir para logs, tickets ou screenshots.

Critério de encerramento

Um caso passa quando todas as etapas observáveis atendem ao contrato dentro do orçamento. Ele falha com uma causa localizada quando isso não ocorre. “Tentar novamente até funcionar” não é critério: mascara defeitos e torna a suíte impossível de confiar.