SDK VisionAcesso antecipado

Seus testes Playwright, verificados pelo Delta-QA. Uma linha por página a verificar.

O @delta-qa/vision envia ao Delta-QA cada página que seus testes do Playwright verificam. O Delta-QA a compara com a referência elemento por elemento e diz qual elemento mudou. Seus testes de regressão escritos em código e seus cenários gravados sem código vivem no mesmo espaço de trabalho: mesmas referências, mesma revisão, mesmo relatório.

Solicitar acesso ao Vision Crie uma conta grátis

O SDK Vision está disponível primeiro em acesso antecipado: fale conosco para usá-lo nos seus testes Playwright.

Três passos nos seus testes

Crie uma chave de API no seu espaço de trabalho Delta-QA e guarde-a em um segredo da sua CI. O SDK a lê em DELTAQA_API_KEY; o espaço é o da chave.
Adicione um check onde o seu teste deve verificar a página: vision.check("Pagamento"). O nome o associa à sua referência.
Faça push. Na primeira execução, cada teste é “Novo”: sua primeira captura se torna a referência. Na segunda, com o site inalterado, nenhuma diferença é apontada.

import { test } from "@playwright/test";
import { Vision } from "@delta-qa/vision";

const vision = new Vision(); // reads DELTAQA_API_KEY

test("Checkout", async ({ page }) => {
  await vision.open(page, { id: "checkout", name: "Checkout" });
  await page.goto("https://shop.example.com/checkout");
  await vision.check("Payment");
  await vision.close(); // fails the test on an unreviewed difference
});

O SDK só expõe configurações que o Delta-QA aplica: nenhuma é aceita sem efeito. O tag e o tag de referência são opcionais; sem eles, o SDK os deduz.

Uma comparação elemento por elemento, não por pixels

A cada verificação, o SDK envia a página (seu HTML, o viewport) e os recursos que o navegador carregou. O Delta-QA reabre a página e compara seus elementos com os da referência, como uma etapa de cenário: o relatório diz qual elemento mudou — o botão “Pagar”, de azul para verde —, não uma área de pixels.

Uma diferença não avaliada faz o teste do Playwright falhar, e o log da CI traz o link do lote. Você abre a etapa, lê o relatório e decide: “Esperado” ou “Bug”.

Cada recurso é reconhecido pelo hash: um recurso que seu espaço de trabalho já tem nunca é reenviado. Na segunda execução de uma suíte, com o site inalterado, só saem o HTML e os hashes.

Uma referência por branch, sem merge automático

O tag é deduzido da sua branch do git ou da CI, e o tag de referência do alvo do PR, ou então de main. Uma branch nova é comparada com main desde a primeira execução, e o lote mostra “comparado com main”.
“Esperado” vale para os tags que você marcar, “só este tag” por padrão: as outras branches não veem nada mudar.
O histórico de um teste se filtra por ambiente e por tag; qualquer análise pode ser definida como referência, para os tags que você marcar.
Os testes de uma execução da CI formam um lote, compartilhado pelas máquinas que rodam em paralelo; a lista de lotes se lê como a sua CI.

Crie seus cenários com um agente de IA: o servidor MCP

Quais frameworks o SDK Vision cobre?

Playwright, em TypeScript e JavaScript, no Chromium. Cypress, WebdriverIO, Firefox e WebKit virão depois. Seus cenários gravados sem código são verificados no mesmo espaço do Delta-QA.

Preciso reescrever meus testes Playwright?

Não: você adiciona um check onde uma página deve ser verificada, e o resto do teste não muda. O nome de um check o associa à sua referência: dois checks com o mesmo nome em um teste fazem a execução falhar, nomeando o duplicado.

Que dados o SDK envia?

A página testada (HTML, viewport) e os recursos que o navegador carregou, exceto vídeo e áudio. Eles servem apenas para comparar e ficam no seu espaço de trabalho. Não teste com dados pessoais de produção: essa escolha é sua.

Meus cenários sem código mudam?

Não: a gravação, a reprodução e o relatório continuam iguais. Agora um cenário pode ser executado sob um tag, e “Esperado” vale para os tags que você marcar.

Posso usá-lo a partir de outra linguagem?

O SDK será em TypeScript e JavaScript. Outra linguagem será adicionada se os usuários pedirem.

Deixe o Delta-QA verificar seus testes Playwright

Para usar o Vision, fale conosco: ele está disponível primeiro em acesso antecipado. Conte quais testes você quer verificar e liberamos seu acesso.