O que é XPath?

XPath é uma pequena linguagem de consulta usada para selecionar partes de um documento XML. Uma expressão como //book/title percorre a árvore de elementos do documento e retorna todos os títulos dentro de um livro, onde quer que estejam. XPath é usado em folhas de estilo XSLT, XML Schema, testes com Selenium e Playwright, ferramentas de extração de dados da web e configurações de muitas ferramentas que leem XML.

Como usar o testador

  1. Digite uma expressão XPath, como //book[price > 15]/title.
  2. Cole o XML abaixo dela.
  3. Os resultados são atualizados enquanto você digita. Um erro de digitação na expressão ou no XML indica o que deu errado e, no caso do XML, a linha e a coluna onde ocorreu.

Como interpretar os resultados

  • Uma expressão que seleciona nós lista todas as correspondências na ordem do documento, com o tipo de cada uma: um elemento aparece como XML indentado, um atributo como name="value" e textos, CDATA e comentários aparecem como texto. O campo Correspondências mostra a quantidade, e o botão de cópia copia todas elas, uma por linha.
  • Uma expressão que calcula um valor, como count(//book) ou contains(//title, 'Garden'), mostra seu único resultado: um número, uma string ou um booleano (verdadeiro ou falso).
  • Textos compostos apenas por espaços e quebras de linha, localizados entre elementos em XML indentado, são identificados como tal para que você possa distingui-los de um resultado vazio.

Namespaces

Os prefixos declarados no XML, como media em xmlns:media="…", podem ser usados na expressão como estão: //media:thumbnail.

Um namespace padrão, declarado como xmlns="…" sem prefixo, costuma ser uma dificuldade. No XPath 1.0, um nome sem prefixo corresponde apenas a elementos que não pertencem a nenhum namespace; por isso, //entry não encontra nada em um feed Atom. O testador atribui o prefixo ns a cada namespace padrão (e depois ns2, ns3, e assim por diante), então //ns:entry funciona. Você também pode encontrar um elemento apenas pelo nome com //*[local-name()='entry']. A tabela de prefixos de namespace lista todos os prefixos que você pode usar.

Exemplos

Com a biblioteca de livros de exemplo:

  • //book/title seleciona os três elementos de título.
  • //book[@genre='garden']/title/text() seleciona como texto os títulos dos livros sobre jardinagem.
  • //book/@id seleciona os atributos id.
  • //book[price > 15]/title seleciona os títulos dos livros que custam mais de 15.
  • count(//book) retorna 3.
  • sum(//price) retorna 51.75.
  • string(//book[last()]/author) retorna o autor do último livro.

Como funciona

O XML é lido com o analisador xmldom, e a expressão é avaliada pela biblioteca xpath, que implementa XPath 1.0 com todas as suas funções e eixos. Ambos são executados no seu navegador, portanto o XML nunca sai do seu dispositivo.

Recursos

  • Expressões XPath 1.0 com predicados, eixos e funções
  • Elementos, atributos, textos, comentários e valores calculados
  • Prefixos de namespace automáticos, incluindo um para um namespace padrão
  • Mensagens de erro com a linha e a coluna de um erro no XML
  • Copie todas as correspondências de uma só vez
  • Executado no seu navegador