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//itemtambém segue a declaração definida no documento. - Modo HTML: Este modo é mais flexível e tolerante, permitindo que caminhos simples como
//acorrespondam 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.