> For the complete documentation index, see [llms.txt](https://docs.roboteasy.tech/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboteasy.tech/studio/geral/obter-elemento-xpath-web.md). # Obter Elemento Xpath WEB ### Visão Geral XPath é uma linguagem de consulta que permite navegar entre os elementos de um documento estruturado, como XML ou HTML. No Genesis, o XPath é usado pelo componente **Buscar Elementos** para localizar e interagir com elementos de páginas web durante automações.

Componente Buscar Elementos configurado com Forma de Busca XPath e o valor do XPath preenchido

*** ### Pré-requisitos * Componente **Abrir Navegador** já configurado e vinculado ao **Buscar Elementos** * Acesso à página web que contém o elemento a ser localizado *** ### Identificando o formato da página A maioria das páginas criadas nos navegadores utiliza a estrutura HTML. Para confirmar que a página é HTML e garantir que o XPath funcionará: #### Passo 1 — Abrir a ferramenta de desenvolvedor (DevTools) Na página do navegador, clique com o **botão direito** em qualquer área e selecione **Inspecionar** (ou **Inspecionar Elemento**). > 💡 Cada navegador tem um atalho diferente para abrir o DevTools — clicar com o botão direito e selecionar **Inspecionar** é o método que funciona em todos. #### Passo 2 — Verificar a declaração DOCTYPE No topo do código exibido, deve aparecer a tag ``. Essa declaração indica que a página é do tipo HTML e, portanto, compatível com busca por XPath. *** ### Formas de busca disponíveis O componente **Buscar Elementos** aceita diferentes formas de localizar um elemento: | Forma de busca | Descrição | | -------------- | --------------------------------------------------------------------- | | XPath | Caminho completo do elemento na árvore do documento (**recomendado**) | | Nome | Valor do atributo `name` do elemento | | ID | Valor do atributo `id` do elemento | | Nome da Classe | Valor do atributo `class` | | Seletor CSS | Seletor no padrão CSS | | Contém Path | Busca por correspondência parcial do caminho | > 💡 **Recomendação:** use **XPath** sempre que possível — é a forma mais precisa e estável para automações. **Exemplo de XPath:**/html/body/div\[2]/div\[4]/form/div\[1]/div/div\[3]/center/input\[2]
### Como usar — Exemplo prático **Objetivo:** abrir o Google e clicar no botão **"Estou com Sorte"**. **Componentes utilizados:** * **Abrir Navegador** — abre um navegador e acessa a URL do Google * **Buscar Elementos** — localiza o botão via XPath e executa uma ação * **Aguardar** — dá tempo entre ações * **Fechar Navegador** — encerra o navegador ao final do processo

Fluxo completo da rotina com os quatro componentes em sequência

#### Passo 1 — Configurar **Abrir Navegador** Adicione o componente **Abrir Navegador** e preencha: * **Selecionar um navegador:** Chrome * **Selecione a versão do navegador:** versão instalada (ex: `109.0.5414`) * **Endereço da página:** `https://www.google.com.br/index.html` * **Verificar se url está disponível:** marcado * **Tempo de espera:** `60`

Configuração do componente Abrir Navegador

#### Passo 2 — Configurar **Buscar Elementos** com o XPath e ação CLICAR Adicione o componente **Buscar Elementos** logo após o **Abrir Navegador** e preencha: * **Automação Web:** selecione o identificador do **Abrir Navegador** (ex: `browseOpen1874`) * **Forma de Busca:** `XPath` * **Valor de busca:** cole o XPath do botão copiado via DevTools * **Tempo máximo de espera (em segundos):** `60` * **Tipo da ação:** escolha a ação desejada (ex: `Clicar`)

Configuração do componente Buscar Elementos com XPath

#### Passo 3 — Configurar **Aguardar** e **Fechar Navegador** Adicione o componente **Aguardar** para dar tempo entre a ação e o encerramento: * **Tempo (em milissegundos):** `10`

Configuração do componente Aguardar

Em seguida, adicione **Fechar Navegador** e vincule ao mesmo identificador do **Abrir Navegador**: * **Selecionar componente do tipo Automação Web:** `browseOpen1874`

Configuração do componente Fechar Navegador

#### Passo 4 — Executar o robô Execute a rotina e observe se as ações ocorrem na ordem esperada: abertura do Google → clique no botão → espera → fechamento do navegador. *** ### Campos e opções — Buscar Elementos | Campo | Descrição | Valores aceitos | | ----------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------- | | Título | Nome de exibição do componente | Texto | | Nome Identificador do Componente | ID único do componente na rotina | Texto (gerado automaticamente) | | Automação Web | Vincula este componente ao **Abrir Navegador** correspondente | Identificador do Abrir Navegador | | Tempo de espera antes de iniciar | Delay em milissegundos antes da execução | Número inteiro | | Tempo de espera após finalizar | Delay em milissegundos após a execução | Número inteiro | | Buscar apenas um / Buscar uma lista | Retorna um único elemento ou uma coleção | Toggle | | Forma de Busca | Estratégia de localização do elemento | XPath, Nome, ID, Nome da Classe, Seletor CSS, Contém Path | | Valor de busca | Valor correspondente à Forma de Busca escolhida | Texto | | Variável de texto do conteúdo do elemento | Armazena o texto do elemento em uma variável | Variável | | Tempo máximo de espera (em segundos) | Tempo limite para localizar o elemento | Número inteiro | | Tipo da ação | Ação a ser executada no elemento encontrado | Nenhuma ação, Clicar, Digitar, etc. | *** ### Observações e dicas * 💡 Use **XPath** sempre que possível — é a forma mais precisa de busca e menos propensa a falhas quando a página tem elementos dinâmicos. * 💡 Para copiar o XPath de um elemento: abra o **DevTools**, clique com botão direito no elemento no painel de código e selecione **Copy → Copy XPath** (ou **Copy full XPath**). * 💡 Sempre vincule o **Buscar Elementos** ao **Abrir Navegador** correto no campo **Automação Web** — sem esse vínculo o componente não sabe em qual navegador atuar. * ⚠️ XPaths absolutos (começando com `/html/body/...`) podem quebrar se a estrutura da página mudar. Para páginas mais voláteis, prefira XPaths relativos baseados em atributos estáveis. * ⚠️ Páginas sem a declaração `` podem ter comportamento inesperado na busca por XPath. ## Baixar o Robô {% file src="/files/JYzXp4QQBdBM9vchd5Zv" %}