Pular para o conteúdo
UseIA
0
Skill

Webapp Testing

Crédito: anthropics no GitHub (anthropics/skills) · 0 cópias

Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026

179,8 mil estrelas no GitHubVer no GitHub
Salvar

Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).

---
name: webapp-testing
description: Conjunto de ferramentas para interagir com aplicações web locais e testá-las usando Playwright. Permite verificar a funcionalidade do frontend, depurar o comportamento da interface, capturar telas do navegador e ver os logs do navegador.
license: Complete terms in LICENSE.txt
---

# Web Application Testing

Para testar aplicações web locais, escreva scripts nativos de Playwright em Python.

**Scripts auxiliares disponíveis**:
- `scripts/with_server.py` - Gerencia o ciclo de vida do servidor (suporta vários servidores)

**Sempre execute os scripts primeiro com `--help`** para ver o uso. NÃO leia o código-fonte até tentar executar o script primeiro e concluir que uma solução personalizada é absolutamente necessária. Esses scripts podem ser muito grandes e poluir a sua janela de contexto. Eles existem para serem chamados diretamente, como caixas-pretas, e não para serem absorvidos pela sua janela de contexto.

## Árvore de decisão: escolhendo a abordagem

```
Tarefa do usuário → É HTML estático?
    ├─ Sim → Leia o arquivo HTML diretamente para identificar os seletores
    │         ├─ Sucesso → Escreva um script Playwright usando os seletores
    │         └─ Falha/Incompleto → Trate como dinâmico (abaixo)
    │
    └─ Não (webapp dinâmico) → O servidor já está rodando?
        ├─ Não → Execute: python scripts/with_server.py --help
        │        Depois use o auxiliar + escreva um script Playwright simplificado
        │
        └─ Sim → Reconhecimento e depois ação:
            1. Navegue e aguarde o networkidle
            2. Tire uma captura de tela ou inspecione o DOM
            3. Identifique os seletores a partir do estado renderizado
            4. Execute as ações com os seletores descobertos
```

## Exemplo: usando o with_server.py

Para iniciar um servidor, execute primeiro `--help` e depois use o auxiliar:

**Um servidor:**
```bash
python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py
```

**Vários servidores (por exemplo, backend + frontend):**
```bash
python scripts/with_server.py \
  --server "cd backend && python server.py" --port 3000 \
  --server "cd frontend && npm run dev" --port 5173 \
  -- python your_automation.py
```

Para criar um script de automação, inclua apenas a lógica do Playwright (os servidores são gerenciados automaticamente):
```python
from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch(headless=True) # Always launch chromium in headless mode
    page = browser.new_page()
    page.goto('http://localhost:5173') # Server already running and ready
    page.wait_for_load_state('networkidle') # CRITICAL: Wait for JS to execute
    # ... your automation logic
    browser.close()
```

## Padrão de reconhecimento e depois ação

1. **Inspecione o DOM renderizado**:
   ```python
   page.screenshot(path='/tmp/inspect.png', full_page=True)
   content = page.content()
   page.locator('button').all()
   ```

2. **Identifique os seletores** a partir dos resultados da inspeção

3. **Execute as ações** usando os seletores descobertos

## Armadilha comum

❌ **Não** inspecione o DOM antes de aguardar o `networkidle` em apps dinâmicos
✅ **Faça** `page.wait_for_load_state('networkidle')` antes da inspeção

## Boas práticas

- **Use os scripts incluídos como caixas-pretas** - Para cumprir uma tarefa, considere se algum dos scripts disponíveis em `scripts/` pode ajudar. Esses scripts tratam com confiabilidade fluxos comuns e complexos sem poluir a janela de contexto. Use `--help` para ver o uso e depois invoque-os diretamente. 
- Use `sync_playwright()` em scripts síncronos
- Sempre feche o navegador ao terminar
- Use seletores descritivos: `text=`, `role=`, seletores CSS ou IDs
- Adicione esperas adequadas: `page.wait_for_selector()` ou `page.wait_for_timeout()`

## Arquivos de referência

- **examples/** - Exemplos que mostram padrões comuns:
  - `element_discovery.py` - Descobrir botões, links e campos de uma página
  - `static_html_automation.py` - Usar URLs file:// para HTML local
  - `console_logging.py` - Capturar logs do console durante a automação