O que é o MailFixture?
O MailFixture é um serviço de teste de e-mail somente para recebimento, criado especificamente para ambientes de CI. Ele oferece caixas de entrada de teste reais por meio de uma única chamada de API, permitindo que seu aplicativo envie e-mails reais—OTPs, links mágicos, códigos de verificação—e que sua suíte de testes os receba analisados, tipados e prontos para asserções. Em vez de lidar com servidores de e-mail falsos ou caixas de entrada descartáveis que acabam em listas de bloqueio, o MailFixture entrega aos seus testes uma caixa de entrada genuína que se comporta como uma real, com a entrega normalmente ocorrendo em menos de um segundo.
Para quem é
- Engenheiros de CI/CD cansados de testes de e-mail instáveis que passam localmente, mas falham no pipeline devido a problemas de tempo ou domínios de teste compartilhados.
- Equipes de automação de QA que usam Playwright, Cypress, pytest ou Selenium e precisam de extração determinística de OTPs e links, sem escrever parsers frágeis com regex.
- Desenvolvedores de agentes de IA que desejam que suas ferramentas baseadas em LLM criem caixas de entrada autonomamente, acionem fluxos de cadastro e leiam códigos de verificação via MCP.
Principais recursos
Long-polling integrado
O waitForMessage() mantém a conexão aberta até o e-mail chegar—geralmente em menos de um segundo após seu aplicativo enviá-lo. Sem sleep(5000), sem loops de polling a cada 500ms, sem desculpas de "instável no CI, funciona localmente". A API espera por você, não o contrário.
Extração de primeira classe
Cada mensagem chega pré-analisada. O código de uso único, o link mágico e o link de verificação são classificados e ficam em um campo extracted, junto com os veredictos de SPF/DKIM/DMARC e uma pontuação de spam do SpamAssassin. Sua asserção é uma única linha e não quebra quando o marketing redesenha o modelo de e-mail.
Domínios personalizados
Aponte um registro MX para o MailFixture e cada fixture viverá em tests.yourdomain.com. Como o domínio é seu, ele nunca é sinalizado como "e-mail descartável detectado" pelos seus próprios formulários de cadastro—um problema que afeta domínios de teste compartilhados.
Dashboard e suporte a MCP
O dashboard permite que você veja as caixas de entrada se enchendo em tempo real, com HTML renderizado, texto simples, cabeçalhos e fonte bruta visíveis—além do OTP extraído a um clique do seu clipboard. O MailFixture também funciona como um servidor MCP remoto, permitindo que agentes de IA criem caixas de entrada e leiam OTPs de forma autônoma.
O que se destaca
"Entregue → analisado → verificado."
Essa é a promessa inteira em seis palavras. A maioria das ferramentas de teste de e-mail para na entrega—elas entregam uma mensagem bruta e esperam que você construa a lógica de análise e asserção. O MailFixture vai além ao tratar OTPs e links de verificação como campos de primeira classe, não como tarefa de regex. Combinado com long-polling que elimina loops de repetição e domínios personalizados que evitam problemas de listas de bloqueio, ele remove as três maiores fontes de instabilidade em testes de e-mail de uma só vez.
Vale a pena conferir se…
Você está construindo testes de ponta a ponta que dependem da entrega de e-mails e está cansado de depurar por que waitForTimeout(5000) não é suficiente. Se sua equipe já lançou um fluxo de cadastro quebrado porque o teste de OTP passou localmente, mas falhou no CI, a abordagem do MailFixture merece uma olhada. O plano gratuito inclui 100 mensagens por mês, sem necessidade de cartão de crédito, e os planos pagos começam em US$ 15/mês, sem preço por assento—você paga por mensagens, não por pessoas. Também é uma ótima opção se você está experimentando agentes de IA que precisam verificar seus próprios fluxos de cadastro de ponta a ponta.
