SDK VisionAcesso antecipado

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

Adicione uma linha aos seus testes Playwright: o Delta-QA compara cada página como o olho humano faria e nomeia o que mudou.

Em acesso antecipado: fale conosco para usá-lo nos seus testes.

Três passos nos seus testes

  1. 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.
  2. Adicione um check onde o seu teste deve verificar a página: checkout.check("Payment"). O nome, único no teste, o associa à sua referência.
  3. 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 "@delta-qa/vision/fixture";

test("Checkout", async ({ page, vision }) => {
  const checkout = await vision.open(page, { id: "checkout", name: "Checkout" });
  await page.goto("https://shop.example.com/checkout");
  await checkout.check("Payment");
}); // closed by the fixture: fails the test on a difference to judge

O SDK só expõe configurações que o Delta-QA aplica: nenhuma é aceita sem efeito. A branch, a branch base e o commit testado são opcionais, e o SDK nunca os adivinha: é o seu teste que os informa.

Vindo do Applitools Eyes? O guia de migração

Uma comparação que simula o olho humano, não pixels

A cada check, como em uma etapa de cenário, o Delta-QA compara a página com sua referência como faria o olho humano: o relatório diz qual elemento mudou — o botão “Pagar”, de azul para verde —, não uma área de pixels.

Uma diferença a avaliar faz o teste do Playwright falhar, e a mensagem de erro traz o link dela no Delta-QA. Você abre a etapa, lê o relatório e decide: “Esperado” ou “Bug”.

A partir da segunda execução, as suas execuções continuam rápidas.

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

  • O seu teste informa a branch, a branch base e o commit: open(page, { branch, baseBranch, commit }), a partir das variáveis da sua CI. O SDK não lê nem o git nem a CI. Uma suíte migrada do Applitools mantém APPLITOOLS_BRANCH, APPLITOOLS_PARENT_BRANCH e APPLITOOLS_BATCH_ID. Uma branch nova é comparada com a referência da sua branch base desde a primeira execução.
  • “Esperado” vale para as branches que você marcar, “esta branch” por padrão: as outras branches não veem nada mudar.
  • O histórico de um teste se filtra por ambiente e por branch; qualquer execução pode ser definida como referência, para as branches que você marcar.
  • Os testes executados sobre um mesmo commit formam uma versão, compartilhada pelas máquinas que rodam em paralelo e informam o mesmo commit; a lista de versões se lê como a sua CI.

As variáveis do GitHub Actions, GitLab CI, Bitbucket Pipelines e Azure Pipelines que contêm a branch, a branch base e o commit: o guia de migração

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

Perguntas sobre o SDK Vision

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?
As páginas que seus testes verificam e os arquivos que elas usam, 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. Um cenário também pode ser executado sob uma branch, e “Esperado” vale para as branches que você marcar.
Posso usá-lo a partir de outra linguagem?
O SDK é para 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.