jovd83/Playwright-skill

O que Playwright-skill faz?

Pacote completo de habilidades Playwright para planejar, criar, depurar, documentar e operacionalizar a automação de testes.

Visão Geral

Este skill agrupa um conjunto de práticas e comandos para trabalhar com Playwright, uma ferramenta moderna de automação de navegador. Ele aborda desde a configuração inicial até a execução em ambientes de integração contínua.

Funcionalidades

• Planejamento: Definição de cenários de teste, mapeamento de fluxos e estratégias de cobertura.
• Criação: Geração de scripts de teste com seletores robustos e ações síncronas/assíncronas.
• Depuração: Uso de ferramentas como --debug, page.pause(), e captura de logs/traces.
• Documentação: Geração automática de relatórios e documentação de testes.
• Operacionalização: Integração com runners, paralelismo, e pipelines CI/CD.

Pré-requisitos

• Node.js 16+
• Playwright instalado: npm init playwright@latest
• Conhecimento básico de JavaScript/TypeScript

Uso Básico

npx playwright test

Ou crie um arquivo de teste:

const { test, expect } = require('@playwright/test');

test('homepage tem título', async ({ page }) => {
  await page.goto('https://example.com');
  await expect(page).toHaveTitle(/Example/);
});

Integração com Assistentes de IA

Este skill é compatível com:

• Claude Code: Use comandos como /playwright para obter trechos de código.
• Cursor: Ative o skill no contexto do projeto para sugestões contextuais.
• Codex: Utilize prompts específicos para gerar scripts de teste.

Melhores Práticas

• Use seletores baseados em texto ou atributos de teste (data-testid).
• Evite esperas fixas; prefira waitForSelector ou asserções automáticas.
• Organize testes em arquivos por funcionalidade ou módulo.
• Execute testes em paralelo para reduzir tempo total.
• Mantenha os testes independentes e sem dependência de estado global.

Suporte

Consulte a documentação oficial do Playwright para mais detalhes ou abra uma issue no repositório do skill.

---

Desenvolvido com ❤️ pela comunidade de automação de testes.