Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/welli7ngton/robotframework-tutorial
Um repositório dedicado ao tutorial da ferramenta de RPA robotframework.
https://github.com/welli7ngton/robotframework-tutorial
api-testing python robotframework rpa tests
Last synced: 13 days ago
JSON representation
Um repositório dedicado ao tutorial da ferramenta de RPA robotframework.
- Host: GitHub
- URL: https://github.com/welli7ngton/robotframework-tutorial
- Owner: welli7ngton
- Created: 2024-06-01T00:00:24.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-06-11T17:36:18.000Z (5 months ago)
- Last Synced: 2024-10-09T23:40:55.550Z (about 1 month ago)
- Topics: api-testing, python, robotframework, rpa, tests
- Language: RobotFramework
- Homepage:
- Size: 28.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# 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](#introdução-ao-xpath)
- [Estrutura Básica de um XPath](#estrutura-básica-de-um-xpath)
- [Seletores Comuns](#seletores-comuns)
- [Selecionar por Tag](#selecionar-por-tag)
- [Selecionar por Atributo](#selecionar-por-atributo)
- [Selecionar por Conteúdo de Texto](#selecionar-por-conteúdo-de-texto)
- [Uso de Funções](#uso-de-funções)
- [Combinação de Seletores](#combinação-de-seletores)
- [Múltiplos Condicionais](#múltiplos-condicionais)
- [Hierarquia de Elementos](#hierarquia-de-elementos)
- [Exemplos Práticos no Robot Framework](#exemplos-práticos-no-robot-framework)
- [Dicas e Boas Práticas](#dicas-e-boas-práticas)
- [Ferramentas Úteis](#ferramentas-úteis)
- [Conclusão](#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.
```robot
*** 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.