Pular para o conteúdo
LabS Atlas
AI For Devs
Entrar

Page Object

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Page Object é o padrão de projeto de testes que representa cada página da aplicação como uma classe com seus elementos e métodos de interação, separando a estrutura da tela da lógica dos testes.

O padrão existe porque testes de interface quebram com facilidade: se cada cenário localiza os elementos por conta própria, uma mudança na tela obriga a reescrever dezenas de testes. Com o page object, o conhecimento sobre a página fica em um lugar só e os testes apenas chamam seus métodos. Ele é peça central de projetos com Selenium e convive com outras duas camadas: os test cases, que descrevem os cenários, e a massa de teste, que fornece as entradas.

Como um page object organiza a página

Cada página da aplicação tem sua própria classe. Para a página inicial do Google, o page object guardaria a barra de pesquisa e o botão de pesquisar, com um método para interagir com cada um. Numa tela de login, ele guarda o campo de e-mail, o campo de senha, o botão de login e a mensagem de erro, cada um com seu método de acesso. Os test cases usam esses métodos: o teste de login com sucesso e o teste de login inválido reaproveitam o mesmo page object de login.

Três ganhos resultam disso:

  • Organização e legibilidade: quem lê o teste entende o que ele faz, sem se perder em localizadores.
  • Manutenção: se o identificador da barra de pesquisa mudar, basta atualizar o page object; nenhum teste precisa ser alterado. O mesmo vale para um campo novo adicionado à tela.
  • Reutilização: os mesmos elementos e métodos servem a vários cenários de sucesso, erro e fluxo.

Outras ferramentas aplicam a mesma lógica com outro nome: no Cypress, por exemplo, comandos personalizados cumprem o papel dos page objects.

Estabilidade dos localizadores: ID, XPath e classe

A qualidade do page object depende de como cada elemento é localizado. O cenário ideal é a página ter IDs únicos em todos os elementos, o que torna a automação simples e estável. Na prática muitas páginas não têm, e o XPath entra como alternativa, conforme a estrutura da página. A classe CSS é o localizador mais arriscado: pode estar duplicada ou aninhada de forma confusa. Um erro de teste causado por uma classe incorreta usada como seletor já consumiu cerca de três horas de investigação até ser encontrado.

Por isso é prática comum pedir ao time de desenvolvimento que adicione IDs nos elementos para facilitar a captura. Algumas ferramentas já ajudam a capturar automaticamente os elementos fixos da tela. Em front-ends com renderização dinâmica o problema se agrava, como discute Desafios de Automação de Testes em Front-end Moderno.

Limite do padrão

O page object funciona bem quando os elementos da tela são fixos. Se um elemento é dinâmico ou muda de nome, o teste quebra e o page object precisa de ajuste manual.

Por que é o artefato prioritário na geração de testes com IA

Entre os artefatos que uma solução de Geração de Cenários de Teste com IA pode produzir, o page object é o mais valioso e o mais viável. Ele muda pouco enquanto a tela não muda: pode ser gerado uma vez e reaproveitado por muitos testes. Se a solução tiver acesso ao HTML da página, consegue extrair os identificadores dos campos (e-mail, senha, botões) e montar a estrutura do page object, o que já é um grande passo para viabilizar o teste automatizado. Gerar a massa de dados a partir disso é ainda mais simples; o test case completo é o artefato mais difícil.

A consequência prática é que a solução precisa conhecer a aplicação. Sem acesso à página, o que ela gera exige muita correção manual; por isso o pedido de teste deve vir acompanhado do link ou das páginas da aplicação.