Automação de Navegador

Use a ferramenta de navegador já selecionada pelo usuário ou instalada no projeto. Playwright, Puppeteer e Selenium têm integrações diferentes; escolha com base nos requisitos reais em vez de alegações de sucesso não comprovadas. Modificado pelos mantenedores do AAS em 05/09/2026: removidas comparações não verificadas e padrões de bypass, esclarecidos limites de espera e evidências.

Separe testes de aplicações que você controla da interação com um navegador autenticado existente. Não substitua este último por uma sessão nova e não autenticada ou extraia credenciais para fazer um teste de automação funcionar.

Guia Detalhado

Leia o guia detalhado antes de executar esta habilidade. Ele contém o procedimento completo e o material de referência. Trate seus requisitos de segurança, pré-requisitos e validação como obrigatórios. Para trabalho focado, carregue as seções relevantes; para trabalho de ponta a ponta, leia o guia completamente.

Exemplo de Teste com Playwright

""" import { test, expect } from '@playwright/test';

// Cada teste é executado em um contexto de navegador isolado test('usuário pode adicionar item ao carrinho', async ({ page }) => { // Contexto novo - sem cookies, sem armazenamento de outros testes await page.goto('/products'); await page.getByRole('button', { name: 'Add to Cart' }).click(); await expect(page.getByTestId('cart-count')).toHaveText('1'); });

test('usuário pode remover item do carrinho', async ({ page }) => { // Completamente isolado - o carrinho está vazio await page.goto('/cart'); await expect(page.getByText('Your cart is empty')).toBeVisible(); }); """

Bons Exemplos (Voltados para o Usuário)

""" // Por role - A MELHOR ESCOLHA await page.getByRole('button', { name: 'Submit' }).click(); await page.getByRole('link', { name: 'Sign up' }).click(); await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible(); await page.getByRole('textbox', { name: 'Search' }).fill('query');

// Por conteúdo de texto await expect(page.getByText('Welcome back')).toBeVisible(); await page.getByText(/Order #\d+/).click(); // Regex suportado

// Por label (formulários) await page.getByLabel('Email address').fill('user@example.com'); await page.getByLabel('Password').fill('secret');

// Por placeholder await page.getByPlaceholder('Search...').fill('query');

// Por ID de teste (quando nenhuma opção voltada para o usuário funciona) await page.getByTestId('submit-button').click(); """

Maus Exemplos (Frágeis)

""" // NÃO FAÇA - Seletores CSS presos à estrutura await page.locator('.btn-primary.submit-form').click(); await page.locator('#header > div > button:nth-child(2)').click();

// NÃO FAÇA - XPath preso à estrutura await page.locator('//div[@class="form"]/button[1]').click();

// NÃO FAÇA - Seletores gerados automaticamente await page.locator('[data-v-12345]').click(); """

Quando Usar

Use para verificar um fluxo de trabalho real do navegador, diagnosticar uma falha de tempo de UI ou coletar dados de página explicitamente autorizados. Inspecione a página atual e as APIs de ferramentas disponíveis antes de selecionar seletores ou ações.

Exemplo Trabalhado e Pré-requisitos

Entrada: exportar um arquivo JSON revisado de um aplicativo web local. Tenha o aplicativo em execução, o navegador pretendido disponível e um valor de formulário sintético. Observe o controle de exportação, registre o evento de download antes de clicar, inspecione o JSON baixado e confirme que a edição da entrada invalida a visualização anterior. Esperado: um arquivo contendo o valor revisado, sem dados ocultos do projeto ou envio de rede.

Use visualizações explícitas de desktop/mobile e inspecione o comportamento do teclado/foco quando a tarefa incluir usabilidade. Um desktop bloqueado deixa a verificação interativa pendente; testes unitários e sondagens sem interface gráfica são evidências separadas.

Limitações

• Verificações de espera automática verificam a ação, não a correção comercial ou gravações bem-sucedidas no backend.
• Capturas de tela, HTML, rastros e arquivos de estado de autenticação podem conter informações privadas; capture apenas o escopo autorizado.
• Tentar ler novamente pode ser seguro; tentar novamente checkout, exclusão ou envio de mensagem pode duplicar um efeito colateral. Verifique o estado antes de repeti-lo.
• Bloqueio de recursos e respostas simuladas alteram o ambiente e não podem estabelecer comportamento de produção não modificado.
• Exemplos exigem as importações do projeto, o runner e as rotas de fixture; nenhum navegador, serviço ou conta é instalado por esta habilidade.