XPath

XPath (XML Path Language) é uma linguagem de consulta para selecionar nós e valores de documentos XML. No Apidog, XPath é usado para extrair dados de respostas de API em XML, validar estruturas XML e criar assertivas para APIs baseadas em XML.

Você pode usar XPath para selecionar nós ou conjuntos de nós em um documento XML seguindo um caminho ou uma série de etapas pela hierarquia do documento.

Exemplo de XML

Usaremos este documento XML nos exemplos a seguir:

<?xml version="1.0" encoding="UTF-8"?>
<bookstore>
  <book>
    <title lang="eng">Harry Potter</title>
    <price>29.99</price>
  </book>
  <book>
    <title lang="eng">Learning XML</title>
    <price>39.95</price>
  </book>
</bookstore>

Seleção de Nós

XPath permite que você selecione nós ou conjuntos de nós em um documento XML seguindo um caminho ou etapas. Abaixo estão algumas das expressões de caminho mais comuns:

Expressão	Descrição
`nodename`	Seleciona todos os filhos deste nó
`/`	Seleciona a partir do nó raiz
`//`	Seleciona nós no documento a partir do nó atual que correspondem à seleção, independentemente de suas posições
`.`	Seleciona o nó atual
`..`	Seleciona o nó pai do nó atual
`@`	Seleciona um atributo

Exemplos de Expressões de Caminho

A tabela a seguir mostra expressões de caminho e seus resultados com base no XML de exemplo:

Expressão de Caminho	Resultado
`bookstore`	Seleciona todos os filhos do elemento bookstore
`/bookstore`	Seleciona o elemento raiz bookstore. Se o caminho começar com uma barra ( / ), então esse caminho sempre representa um caminho absoluto para um elemento
`bookstore/book`	Seleciona todos os elementos book que são filhos de bookstore
`//book`	Seleciona todos os elementos book independentemente de sua posição no documento
`bookstore//book`	Seleciona todos os elementos book que são filhos de elementos bookstore, independentemente de onde estejam localizados sob bookstore
`//@lang`	Seleciona todos os atributos chamados lang

Caminhos Absolutos vs. Relativos

Caminhos que começam com / são absolutos (a partir da raiz), enquanto caminhos sem / são relativos ao nó atual.

Predicados

Você pode usar predicados para encontrar um nó específico ou um nó que contenha um valor especificado. Predicados ficam entre colchetes e permitem uma filtragem poderosa.

Exemplos de Predicados

Expressão de Caminho	Resultado
`/bookstore/book[1]`	Seleciona o primeiro elemento book dos elementos filhos de bookstore
`/bookstore/book[last()]`	Seleciona o último elemento book dos elementos filhos de bookstore
`/bookstore/book[last()-1]`	Seleciona o penúltimo elemento book dos elementos filhos de bookstore
`/bookstore/book[position()<3]`	Seleciona os dois primeiros elementos book dos elementos filhos de bookstore
`//title[@lang]`	Seleciona todos os elementos title que têm um atributo chamado lang
`//title[@lang='eng']`	Seleciona todos os elementos title que têm um atributo lang com o valor eng
`/bookstore/book[price>35.00]`	Seleciona todos os elementos book de bookstore com o valor do elemento price maior que 35.00
`/bookstore/book[price>35.00]//title`	Seleciona todos os elementos title do elemento book em bookstore com o elemento price maior que 35.00

Indexação de Predicados

XPath usa indexação baseada em 1 para predicados, ao contrário de JSONPath, que usa indexação baseada em 0. O primeiro elemento é [1], não [0].

Seleção de Nós Desconhecidos

O curinga do XPath pode ser usado para selecionar elementos XML desconhecidos sem saber seus nomes exatos.

Sintaxe de Curinga

Curinga	Descrição
`*`	Corresponde a qualquer nó de elemento
`@*`	Corresponde a qualquer nó de atributo
`node()`	Corresponde a qualquer tipo de nó

Exemplos de Curinga

Expressão de Caminho	Resultado
`/bookstore/*`	Seleciona todos os elementos filhos do elemento bookstore
`//*`	Seleciona todos os elementos no documento
`//title[@*]`	Seleciona todos os elementos title com atributos

Uso de Curingas

Curingas são úteis ao trabalhar com estruturas XML dinâmicas ou quando você deseja selecionar todos os elementos independentemente de seus nomes.

Selecionar Vários Caminhos

Você pode selecionar vários caminhos usando o operador | em uma expressão de caminho, permitindo combinar várias seleções.

Exemplos de Vários Caminhos

Expressão de Caminho	Resultado
`//book/title \| //book/price`	Seleciona todos os elementos title e price do elemento book
`//title \| //price`	Seleciona todos os elementos title e price no documento
`/bookstore/book/title \| //price`	Seleciona todos os elementos title do elemento book do elemento bookstore e todos os elementos price no documento

Casos de Uso no Apidog

XPath é particularmente útil no Apidog para:

Validação de Resposta XML: extrair valores específicos de respostas de API em XML para verificar a correção

Teste de API SOAP: analisar e validar respostas SOAP

Variáveis Dinâmicas: armazenar valores XML extraídos para uso em requisições subsequentes

Assertivas de Teste: criar assertivas com base em dados de resposta XML

Extração de Dados: extrair campos específicos de estruturas XML aninhadas complexas

XML vs. JSON

Embora JSON seja mais comum em APIs modernas, muitos sistemas legados e serviços baseados em SOAP ainda usam XML. XPath é essencial para testar essas APIs.

Referências

Especificação XPath do W3C

Tutorial de XPath - W3Schools

Testador de XPath

Exemplo de XML#

Seleção de Nós#

Exemplos de Expressões de Caminho#

Predicados#

Exemplos de Predicados#

Seleção de Nós Desconhecidos#

Sintaxe de Curinga#

Exemplos de Curinga#

Selecionar Vários Caminhos#

Exemplos de Vários Caminhos#

Casos de Uso no Apidog#

Referências#

Exemplo de XML

Seleção de Nós

Exemplos de Expressões de Caminho

Predicados

Exemplos de Predicados

Seleção de Nós Desconhecidos

Sintaxe de Curinga

Exemplos de Curinga

Selecionar Vários Caminhos

Exemplos de Vários Caminhos

Casos de Uso no Apidog

Referências