Guia de Estrutura de Escrita de XPath para Automação com Robot Framework

Introdução

Este guia fornece uma estrutura detalhada sobre como escrever expressões XPath eficazes para automação de testes com o Robot Framework. XPath é uma linguagem usada para navegar por elementos e atributos em um documento XML ou HTML, essencial para localizar elementos em páginas web.

Índice

• Introdução ao XPath
• Estrutura Básica de um XPath
• Seletores Comuns
  • Selecionar por Tag
  • Selecionar por Atributo
  • Selecionar por Conteúdo de Texto
  • Uso de Funções
• Combinação de Seletores
  • Múltiplos Condicionais
  • Hierarquia de Elementos
• Exemplos Práticos no Robot Framework
• Dicas e Boas Práticas
• Ferramentas Úteis
• Conclusão

Introdução ao XPath

XPath permite selecionar elementos em um documento XML ou HTML com base em diversos critérios. Existem dois tipos principais de seletores XPath:

• XPath Absoluto: Navega pela hierarquia completa do documento a partir da raiz.
• XPath Relativo: Navega a partir do nó atual ou de um nó específico, utilizando seletores mais flexíveis.

Estrutura Básica de um XPath

XPath Absoluto

xpath /html/body/div[1]/div[2]/a

XPath Relativo

xpath //div[@class='example']/a

Seletores Comuns

Selecionar por Tag

xpath //tagname

xpath //button

Selecionar por Atributo

xpath //tagname[@attribute='value']

xpath //input[@id='username']

Selecionar por Conteúdo de Texto

xpath //tagname[text()='value']

xpath //button[text()='Submit']

Uso de Funções

contains()

Seleciona elementos que contêm um determinado valor.

xpath //tagname[contains(@attribute, 'value')]

xpath //a[contains(@href, 'login')] starts-with()

Seleciona elementos cujo valor de atributo começa com um determinado valor.

xpath //tagname[starts-with(@attribute, 'value')]

xpath //div[starts-with(@class, 'header')]

Combinação de Seletores

Múltiplos Condicionais

Você pode combinar várias condições usando and e or.

xpath //tagname[@attribute1='value1' and @attribute2='value2']

xpath //input[@type='text' and @name='username'] Hierarquia de Elementos

Você pode navegar através da hierarquia de elementos.

xpath //parentTag/childTag

xpath //div/form/input

Exemplos Práticos no Robot Framework

Configurando o Ambiente No arquivo de teste do Robot Framework (.robot), importe a biblioteca SeleniumLibrary para usar seletores XPath.

*** Settings ***
Library    SeleniumLibrary

*** Variables ***
${URL}    https://example.com

*** Test Cases ***
Test Example
    Open Browser    ${URL}    Chrome
    # Localizar elemento por XPath absoluto
    Click Element    /html/body/div[1]/div[2]/a
    # Localizar elemento por XPath relativo
    Input Text    //input[@id='username']    myusername
    Click Button    //button[text()='Submit']
    Close Browser

Dicas e Boas Práticas:

• Prefira XPath Relativo: Eles são menos propensos a quebrar quando a estrutura da página muda.
• Use Funções XPath: Funções como contains() e starts-with() tornam os seletores mais flexíveis.
• Teste Seus Seletores: Utilize ferramentas de desenvolvedor nos navegadores (como o Chrome DevTools) para testar seus seletores XPath antes de usá-los em scripts de automação.
• Mantenha a Simplicidade: Escreva seletores simples e claros para facilitar a manutenção do código.

Ferramentas Úteis

• Chrome DevTools: Inspecione elementos e teste XPath diretamente no console.
• Firefox Developer Tools: Oferece ferramentas semelhantes ao Chrome DevTools.
• XPath Helper: Extensão para navegadores que ajuda a criar e testar expressões XPath.

Conclusão

• Compreender e utilizar expressões XPath eficazes é fundamental para a automação de testes com o Robot Framework. Este guia fornece uma base sólida para começar a escrever e otimizar seletores XPath, permitindo a criação de scripts de automação mais robustos e resilientes.