Projeto Playwright Consulta

Este projeto centraliza utilitários, dados de configuração e funções comuns para automação de testes Playwright. Ideal para ser importado em outros projetos de automação, facilitando consultas, validações e acesso a dados sensíveis de teste.

Instalação

1. Clone ou adicione como dependência local:

   git clone <url-do-repositorio>
   cd playwright-consulta
   npm install

2. Instale os navegadores do Playwright:

   npx playwright install

Exemplos de uso

Importe os módulos desejados:

import { gerarCPF, gerarEnderecoBR, gerarCartaoCredito, validarEmail } from './utils/index.js';
import { URL_PORTAL_LOGIN } from './data/config.js';
import { TEST_USER_ADMIN } from './data/usuarios.js';

Utilize nos seus testes:

const cpf = gerarCPF(true);
const endereco = gerarEnderecoBR();
const cartao = gerarCartaoCredito();
if (validarEmail(TEST_USER_ADMIN.login)) {
  // ...
}

Estrutura

• utils/: Funções utilitárias para automação (geração de dados, validações, manipulação de cookies/storage, etc)
• data/config.js: URLs e configurações centralizadas
• data/usuarios.js: Dados de usuários de teste
• tests/: Exemplos de uso e testes automatizados
• playwright.config.js: Configuração do Playwright

Requisitos

• Node.js >= 16
• Playwright

Documentação dos Utilitários

Todos os métodos utilitários deste projeto seguem o padrão de documentação JSDoc (similar ao Javadoc), facilitando o entendimento e uso das funções.

Exemplo:

/**
 * Gera um CPF válido aleatório.
 * @param {boolean} [comMascara=false] Se true, retorna com máscara
 * @returns {string}
 */
export function gerarCPF(comMascara = false) { ... }

Para contribuir, mantenha a documentação JSDoc em todos os métodos exportados.

Contribuição

Sugestões, melhorias e novas funções são bem-vindas! Basta abrir um pull request ou issue.

Referências

• Playwright Documentation