Teste visual no Storybook sem Chromatic: grátis e sem código

Teste visual no Storybook sem Chromatic: grátis e sem código

O teste visual (visual testing) é um método de verificação automatizada que compara screenshots de uma interface (ou de um componente isolado) com imagens de referência para detectar qualquer regressão gráfica involuntária.

Se você usa Storybook, provavelmente conhece o Chromatic. É a ferramenta de teste visual desenvolvida pela própria equipe do Storybook, integrada tão profundamente ao ecossistema que se poderia achar que é a única opção disponível. Não é. E acreditar no contrário é uma armadilha em que muitas equipes caem.

Este artigo explora por que a dependência de um único fornecedor para o teste visual dos seus componentes Storybook é uma estratégia arriscada, quais alternativas realmente existem e como escolher a abordagem que corresponde ao seu contexto.

O essencial em uma página: definição, automação sem código, grade de escolha de uma ferramenta: Testes de regressão automatizados, sem código.

Testar seus componentes Storybook não deveria prender você a um único fornecedor. O Delta-QA compara suas stories sem código, com conta gratuita e sem cartão de crédito. Testar o Delta-QA grátis →

Por que Storybook e teste visual andam juntos

O Storybook transformou a forma como as equipes de front-end desenvolvem e documentam seus componentes. Cada componente vive isolado, com suas variantes, seus estados, seus edge cases. É um catálogo vivo do seu design system.

Mas um catálogo sem verificação automatizada é um museu que esquecemos de vigiar. Um desenvolvedor modifica um token de cor no tema global. Outro ajusta um padding para corrigir um bug em uma página. Um terceiro atualiza uma dependência CSS. Nenhuma dessas mudanças quebra um teste unitário. Nenhuma faz falhar um teste de integração. Mas, visualmente, três componentes agora estão desfigurados.

O teste visual preenche esse vazio. Ele captura a aparência real de cada componente no Storybook e detecta os desvios em relação a uma referência aprovada. É a rede de segurança que seus testes funcionais não oferecem.

Atenção, porém: testar seus componentes isoladamente no Storybook continua insuficiente assim que esses componentes são montados por várias equipes. Se você trabalha em arquitetura distribuída, leia por que o teste visual de micro-frontends na página montada é a única forma de detectar os conflitos de CSS e as quebras de layout que só aparecem na integração.

Chromatic: o que faz bem, e o problema

Digamos de saída: o Chromatic é um bom produto. A integração com o Storybook é fluida: lógico, já que é a mesma equipe. O workflow de revisão é bem pensado. A detecção de mudanças é cuidadosa, e o TurboSnap só recaptura as stories afetadas por uma mudança de arquivos. Em 10/2026, aliás, o Chromatic não se limita mais ao Storybook: captura também páginas de testes Playwright, Cypress ou Vitest, acrescenta testes de interação e de acessibilidade e renderiza as capturas em Chrome, Firefox, Safari e Edge.

Então, qual é o problema?

O lock-in de fornecedor é real

Quando todo o seu pipeline de teste visual depende de um único serviço em nuvem, você confia a ele um poder considerável sobre o seu workflow de entrega. Se o Chromatic mudar os preços (o que acontece com regularidade no SaaS), você não tem um plano B pronto para implantar. Se o serviço sofrer uma queda, suas merge requests esperam. Se a API evoluir e quebrar a sua integração, é a sua CI que para.

Isso não é paranoia. É gestão de riscos elementar.

A cobrança por snapshot é uma bomba-relógio

O Chromatic cobra pelo número de snapshots. Em 10/2026, o plano gratuito inclui 5.000 snapshots por mês só no Chrome; o Starter sai a US$ 179/mês para 35.000 snapshots e libera Firefox, Safari e Edge; o Pro a US$ 399/mês para 85.000; cada snapshot extra custa US$ 0,008. No começo, com 50 componentes e 3 variantes cada, a conta é razoável. Mas um design system cresce. As variantes se multiplicam. Os temas se acrescentam. Um ano depois, você tem 400 stories e a conta foi multiplicada por oito. Nesse ponto, reduzir o número de snapshots significa reduzir a cobertura de teste: exatamente o contrário do que você quer. O TurboSnap amortece essa alta recapturando só o que mudou, desde que seja ativado e ajustado.

Seus dados de teste saem da sua infraestrutura

Para equipes sujeitas a restrições de conformidade (saúde, finanças, setor público), enviar screenshots de interfaces a um serviço de nuvem de terceiros não é banal. Mesmo que, em teoria, os screenshots não contenham dados sensíveis, as políticas de segurança nem sempre fazem essa distinção.

As alternativas ao Chromatic para o Storybook visual testing

Percy (BrowserStack)

O Percy é o concorrente direto mais estabelecido. Sua abordagem: você captura snapshots das suas stories do Storybook, o Percy as renderiza em navegadores reais na nuvem, e você revisa as diferenças em um dashboard.

O que funciona. O Percy lida com cross-browser de forma nativa. Você testa seus componentes em Chrome, Firefox e Safari sem configurar nada localmente. O dashboard de revisão é maduro e o workflow de aprovação é sólido.

O que é um problema. Você troca um fornecedor de nuvem por outro. A cobrança também é baseada em snapshots. E a integração com o Storybook, embora funcional, não é tão nativa quanto a do Chromatic: logicamente, o Percy não foi concebido especificamente para o Storybook.

O Percy faz sentido se a sua necessidade principal é o teste visual cross-browser e você está à vontade com um modelo de nuvem pago. Mas ele não resolve o problema fundamental da dependência de fornecedor.

Playwright com toHaveScreenshot()

O Playwright integra nativamente a comparação de screenshots. Com um pouco de configuração, você pode usá-lo para capturar e comparar visualmente suas stories do Storybook.

O que funciona. Tudo roda localmente ou na sua própria CI. Sem serviço de nuvem de terceiros. Sem cobrança por snapshot. As baselines vivem no seu repositório, sob seu controle total. E o Playwright é mantido pela Microsoft: a continuidade não é um assunto.

O que é um problema. A implantação dá trabalho. Você precisa escrever a lógica que abre cada story em um navegador headless, tira um screenshot e o compara. A configuração inicial de um script Playwright/Storybook é documentada, mas você vai manter esse código. Os falsos positivos da comparação pixel a pixel exigirão ajustes. E não há dashboard de revisão: quando um teste falha, você abre arquivos PNG localmente para entender o que mudou.

O Playwright é a escolha técnica sólida para equipes que têm as competências internas e querem zero dependência externa. Mas é um investimento em manutenção.

BackstopJS

O BackstopJS é uma ferramenta open source dedicada à regressão visual. Ele pode mirar URLs: logo, suas stories do Storybook servidas localmente.

O que funciona. É gratuito, open source, e o relatório HTML gerado é mais legível do que uma pasta de arquivos de diff. A configuração por cenários JSON é clara. É, aliás, uma das ferramentas gratuitas de teste visual mais conhecidas do ecossistema.

O que é um problema. O projeto teve fases de manutenção intermitente. A integração com o Storybook não é direta: você precisa apontar o BackstopJS para as URLs individuais de cada story. A configuração por cenários JSON é documentada, mas, na escala de um design system grande, a gestão dos cenários fica verbosa.

Delta-QA: a abordagem sem código

O Delta-QA encara o problema de outro modo. Sem scripts para escrever. Você abre suas stories do Storybook servidas (em um Storybook implantado ou em um ambiente de homologação) e grava o fluxo sem código; o Delta-QA reexecuta as páginas em um navegador real, as compara como faria o olho humano e apresenta as diferenças em uma interface de revisão dedicada: o relatório diz qual elemento mudou. Para as equipes que preferem verificar a partir dos testes Playwright, o Delta-QA agora tem um SDK, o SDK Vision.

O que muda. O teste visual dos seus componentes Storybook deixa de depender da sua stack de testes. Sua equipe de QA pode configurar e manter a cobertura visual sem tocar no código dos testes. Os designers podem participar do workflow de revisão: veem as diferenças visuais sem precisar entender um relatório de teste.

O que é diferente em relação ao Chromatic. A conta gratuita é criada sem cartão de crédito, e a oferta On-Premise (POC gratuito de um mês) mantém suas capturas na sua infraestrutura se você precisar. Em contrapartida, o Delta-QA compara hoje em Chromium; Firefox e WebKit estão previstos.

Teste visual sem dependência de fornecedor é possível. O Delta-QA compara suas stories do Storybook sem código, com conta gratuita: nenhuma assinatura do Chromatic necessária. Testar o Delta-QA grátis →

Como escolher: a grade de decisão

Em vez de fingir que uma solução serve para todos (seria falso), eis as perguntas a se fazer.

Você tem restrições de soberania de dados? Se sim, elimine Chromatic e Percy. Sobram Playwright, BackstopJS e Delta-QA.

Sua equipe tem as competências para manter scripts de teste visual? Se não, elimine Playwright e BackstopJS. O sem código do Delta-QA ou o gerenciado do Chromatic/Percy são mais adequados.

Seu design system está em crescimento ativo? Se sim, desconfie da cobrança por snapshot. O que custa 50 € por mês hoje pode custar 500 € em um ano.

Quantos navegadores você precisa cobrir? Se o cross-browser é crítico, Percy e Chromatic (a partir do plano Starter) cobrem vários navegadores; o Delta-QA compara hoje em Chromium. Para os demais, um navegador Chromium muitas vezes basta para detectar regressões visuais.

Você quer envolver não desenvolvedores na revisão? Se seus designers ou sua equipe de QA precisam validar as mudanças visuais, uma ferramenta com interface de revisão acessível (Delta-QA, Chromatic, Percy) será preferível a uma pasta de arquivos PNG no Git.

O risco oculto: a monocultura de ferramentas

Além da escolha de ferramenta, há um princípio mais fundamental que muitas equipes negligenciam: não ponha todos os seus testes na mesma cesta de fornecedor.

Se a sua CI, seus testes funcionais, seus testes visuais e seu monitoramento dependem de um único ecossistema, uma única decisão de negócio desse fornecedor pode paralisar o pipeline inteiro. Vale para o Chromatic, vale para qualquer ferramenta.

A resiliência, em engenharia de software, passa pela diversificação. Você não hospeda seu banco de dados e sua aplicação na mesma máquina física. Aplique a mesma lógica ao seu ferramental de teste.

Migrar do Chromatic: por onde começar

Se você está hoje no Chromatic e considera uma alternativa, não faça um big bang. Proceda por etapas.

Etapa 1: identifique suas stories críticas. Não todas as suas stories. Os 20 % que cobrem 80 % dos componentes visíveis para os seus usuários.

Etapa 2: configure a alternativa em paralelo. Rode o Delta-QA (ou o Playwright, ou a ferramenta de sua escolha) nessas stories críticas ao mesmo tempo que o Chromatic. Compare os resultados durante dois a três sprints.

Etapa 3: amplie progressivamente. Estabelecida a confiança, estenda a cobertura e reduza o uso do Chromatic proporcionalmente.

Etapa 4: corte o cordão. Quando a cobertura alternativa atingir um nível satisfatório, desative o Chromatic.

Essa abordagem leva tempo. Mas evita o cenário catastrófico em que você descobre os limites da nova ferramenta em produção.

FAQ

O teste visual do Storybook é mesmo necessário se temos testes unitários?

Sim. Os testes unitários verificam se o seu componente funciona: se aceita as props certas, renderiza o conteúdo certo, reage aos eventos. O teste visual verifica se ele se parece com o que deveria. Um componente pode passar em todos os testes unitários e ter o layout completamente quebrado. São duas dimensões complementares.

Dá para usar o Playwright para testar visualmente o Storybook sem Chromatic?

Com certeza. O Playwright pode navegar até cada story individualmente e comparar screenshots. O esforço está na implantação e na manutenção: você precisa escrever o código que percorre suas stories, gerenciar as baselines e tratar os falsos positivos. É viável, mas é um investimento em tempo de engenharia.

O Delta-QA funciona diretamente com o Storybook?

Sim. O Delta-QA pode abrir qualquer URL servida, inclusive as stories individuais do Storybook. Você não precisa modificar a configuração do Storybook nem instalar um plugin. Basta que o seu Storybook seja acessível a partir do Delta-QA (implantado, ou na sua rede com a oferta On-Premise) para gravar um cenário e comparar seus componentes.

A comparação pixel a pixel é confiável para componentes do Storybook?

É confiável se o seu ambiente de renderização for perfeitamente estável: mesmo SO, mesmo navegador, mesma resolução, mesmas fontes. Na prática, obter essa estabilidade entre a máquina de um desenvolvedor e um runner de CI dá trabalho. As abordagens perceptuais (que toleram diferenças menores de renderização) ou as ferramentas que gerenciam essa estabilidade para você reduzem consideravelmente os falsos positivos.

Quanto custa o teste visual do Storybook se sairmos do Chromatic?

Depende da alternativa. Playwright e BackstopJS são gratuitos (open source), mas custam tempo de engenharia. O Percy cobra por snapshot como o Chromatic (em 10/2026, Chromatic: grátis até 5.000 snapshots por mês, depois US$ 179 ou US$ 399 por mês conforme o volume). O Delta-QA começa com uma conta gratuita, sem cartão de crédito. Faça a conta com o seu número real de stories e variantes.

É possível combinar várias ferramentas de teste visual no mesmo projeto?

Não só é possível como às vezes é recomendado. Você poderia usar o Playwright para os testes visuais críticos no pipeline de CI e o Delta-QA para a revisão colaborativa com a equipe de design. A diversificação reduz o risco de dependência e permite aproveitar os pontos fortes de cada ferramenta.

Conclusão

O storybook visual testing é indispensável para qualquer equipe que mantém um design system sério. Mas a ferramenta que você escolhe para fazê-lo tem implicações que vão bem além da técnica. Afeta seu orçamento, sua autonomia e a resiliência do seu pipeline de entrega.

O Chromatic é uma boa ferramenta. Não é a única. E num contexto em que flexibilidade e independência são vantagens estratégicas, explorar alternativas não é luxo: é prudência.

Se você procura uma abordagem sem código, em SaaS ou On-Premise, que funcione com o Storybook como com qualquer aplicação web, o Delta-QA merece a sua atenção.

Pronto para retomar o controle do seu teste visual? Inicie sua primeira comparação de stories com o Delta-QA, com conta gratuita e sem cartão de crédito. Testar o Delta-QA grátis →