Testador de XPath

Teste expressões XPath em XML ou HTML e inspecione cada nó, valor e caminho correspondente.

Tipo de entrada
Entrada XML / HTML
Resultados
Insira o XML ou HTML e uma expressão XPath para testar.

O seu XML, HTML e XPath são testados diretamente no seu navegador. Nada é enviado para o BroBroGo.

Perguntas Frequentes

Posso testar XPath em HTML além de XML?

Sim. O modo XML segue estritamente as regras de namespace do XML. O modo HTML é mais flexível e permite que caminhos simples como //a correspondam a tags normais de HTML.

Como funcionam os namespaces XML?

Prefixos de namespace declarados no seu XML podem ser usados no XPath, como //x:item. Para namespaces padrão, //item também segue a declaração do documento.

Porque é que uma consulta pode expirar (timeout)?

Documentos muito grandes ou expressões muito amplas podem exigir muito processamento. A ferramenta interrompe a execução após 2 segundos para manter a página responsiva; restrinja o caminho ou tente um exemplo menor.

O que é o Testador de XPath

O Testador de XPath é uma ferramenta concebida para testar expressões XPath diretamente contra conteúdo XML ou HTML fornecido pelo utilizador. A ferramenta identifica e apresenta todas as partes do conteúdo que correspondem à expressão introduzida, detalhando o tipo de nó, o nome, o caminho e uma pré-visualização do respetivo valor. Adicionalmente, é possível copiar individualmente o valor de qualquer resultado obtido.

Esta aplicação funciona de forma inteiramente local. O processamento é realizado diretamente no seu navegador, o que significa que o seu XML, HTML e XPath são testados localmente e nada é enviado para o BroBroGo.


Como Utilizar a Ferramenta e Parâmetros de Entrada

Para realizar um teste, deve configurar os seguintes campos de entrada na interface:

  • Entrada XML / HTML (Entrada XML / HTML): O conteúdo de texto em formato XML ou HTML que deseja analisar. Este campo aceita um comprimento máximo de 500 000 caracteres.
  • Expressão XPath (Expressão XPath): A expressão XPath que pretende avaliar no documento. O comprimento máximo permitido para este campo é de 4 000 caracteres.
  • Tipo de entrada (Tipo de entrada): Uma escolha simples entre o modo XML ("XML") ou o modo HTML ("HTML").

Após preencher estes dados, a ferramenta processa a informação e disponibiliza os seguintes resultados e métricas:

  • Resultados (Resultados): Indica o número total de correspondências encontradas.
  • Detalhes (Detalhes): Para cada nó correspondente, a ferramenta exibe o seu tipo, nome, caminho e uma pré-visualização.
  • Copiar resultado (Copiar resultado): Um botão dedicado para copiar o valor de um resultado individual.
  • Caracteres (Caracteres): O número total de caracteres presentes no documento de entrada.
  • Resultados (Resultados): O número de resultados atualmente exibidos no ecrã.

Diferenças entre o Modo XML e o Modo HTML

A escolha do tipo de entrada altera a forma como o documento é interpretado e processado:

  • Modo XML: Neste modo, as regras de namespace do XML são seguidas de forma estrita. Os prefixos de namespace declarados no seu XML podem ser utilizados na expressão XPath (por exemplo, //x:item). No caso de namespaces padrão no XML, a expressão //item também segue a declaração definida no documento.
  • Modo HTML: Este modo é mais flexível e tolerante, permitindo que caminhos simples como //a correspondam a tags normais de HTML.

É importante salientar que esta ferramenta de teste não representa a estrutura em tempo real, o DOM renderizado ou os pedidos de rede de páginas online. Trata-se de um analisador estático para o texto fornecido.


Regras de Execução e Mensagens de Erro

Para garantir a estabilidade do navegador e uma experiência de utilização fluida, a ferramenta aplica regras estritas de validação e limites de tempo:

  • Limite de tempo (Timeout): A avaliação de uma expressão XPath é interrompida após 2 segundos para manter a página responsiva. Se a execução demorar demasiado tempo, é exibida a mensagem: "Este XPath demorou muito para ser executado. Restrinja a expressão ou use um exemplo menor.".
  • Documento demasiado grande: Se o documento inserido ultrapassar os limites práticos de processamento, surge o aviso: "Este documento é grande demais para ser testado aqui. Tente um exemplo menor.".
  • Expressão demasiado longa: Se a expressão XPath exceder o limite de caracteres, a ferramenta mostra a mensagem: "Esta expressão XPath é longa demais para ser testada aqui.".
  • Erro de análise do documento: Caso o documento de entrada possua erros estruturais que impeçam a sua leitura, é exibida a mensagem: "Não foi possível analisar este documento.".
  • Expressão inválida: Se a sintaxe do XPath estiver incorreta, surge o aviso: "Esta expressão XPath não é válida.".
  • Erro de avaliação: Se ocorrer um problema genérico durante o processamento do caminho, a ferramenta indica: "Não foi possível avaliar este XPath.".
  • Sem correspondências: Quando a pesquisa não encontra qualquer elemento, é apresentada a mensagem: "Nenhum resultado.".
  • Limite de exibição de resultados: Quando são encontrados mais de 200 resultados, a ferramenta limita a exibição para manter o desempenho, mostrando a nota "Exibindo os primeiros {max}." e listando apenas as primeiras 200 correspondências.

Perguntas Frequentes

Posso testar XPath em HTML além de XML?
Sim. O modo XML segue estritamente as regras de namespace do XML. O modo HTML é mais flexível e permite que caminhos simples como //a correspondam a tags normais de HTML.

Como funcionam os namespaces XML?
Os prefixos de namespace declarados no seu XML podem ser usados no XPath, como //x:item. Para namespaces padrão, a expressão //item também segue a declaração do documento.

Porque é que uma consulta pode expirar (timeout)?
Documentos muito grandes ou expressões muito amplas podem exigir muito processamento. A ferramenta interrompe a execução após 2 segundos para manter a página responsiva; restrinja o caminho ou tente um exemplo menor.