Présentation du Testeur XPath
Le Testeur XPath est un outil conçu pour évaluer et valider des expressions XPath par rapport à du contenu XML ou HTML fourni par l'utilisateur. Il permet d'identifier précisément les parties d'un document qui correspondent à une expression donnée, en affichant des informations détaillées pour chaque correspondance.
Pour chaque nœud correspondant trouvé, l'outil affiche son type, son nom, son chemin ainsi qu'un aperçu de sa valeur. De plus, il est possible de copier individuellement la valeur de n'importe quel résultat obtenu.
Fonctionnalités et données d'entrée
Pour effectuer une évaluation, l'outil requiert la configuration de plusieurs paramètres d'entrée:
- Entrée XML / HTML: Le document textuel source, au format XML ou HTML. La longueur maximale autorisée pour ce document est de 500 000 caractères.
- Expression XPath: L'expression XPath que vous souhaitez tester. Sa longueur maximale est limitée à 4 000 caractères.
- Type d’entrée: Un sélecteur vous permettant de choisir explicitement entre le « XML » (mode XML) et le « HTML » (mode HTML).
Résultats et données de sortie
Une fois l'évaluation lancée, l'outil affiche plusieurs indicateurs et données de sortie:
- Résultats: Un compteur global indiquant le nombre total de correspondances trouvées.
- Détail: Pour chaque nœud correspondant, l'outil présente son type, son nom, son chemin et un aperçu.
- Bouton de copie: Un bouton dédié permet de copier la valeur d'un résultat individuel.
- Caractères: Le nombre exact de caractères que contient le document d'entrée.
- Résultats affichés: Le nombre de résultats effectivement visibles à l'écran.
Règles de fonctionnement et cas limites
Le traitement des expressions et des documents est soumis à plusieurs règles strictes afin de garantir la stabilité de l'application:
- Limite de temps d'exécution: L'évaluation d'une expression XPath est interrompue après 2 secondes afin de maintenir la réactivité de la page. Si ce délai est dépassé, le message « Ce XPath a pris trop de temps. Resserrez l’expression ou utilisez un exemple plus petit. » s'affiche.
- Taille du document: Si le document d'entrée dépasse la limite de taille, l'outil affiche le message « Ce document est trop volumineux pour être testé ici. Utilisez un exemple plus petit. ».
- Longueur de l'expression: Si l'expression XPath saisie est trop longue, le message « Cette expression XPath est trop longue pour être testée ici. » apparaît.
- Erreurs d'analyse et de syntaxe:
- Si le document d'entrée ne peut pas être analysé, le message « Impossible d’analyser ce document. » est généré.
- Si l'expression XPath n'est pas valide grammaticalement, l'outil affiche « Cette expression XPath n’est pas valide. ».
- Si l'évaluation de l'expression échoue pour une autre raison, le message « Impossible d’évaluer ce XPath. » est présenté.
- Absence de correspondance: Si aucun élément ne correspond à la recherche, l'outil affiche « Aucun résultat. ».
- Limitation de l'affichage: Lorsque l'évaluation retourne plus de 200 résultats, l'outil limite l'affichage aux 200 premières correspondances et affiche la mention « Affichage des
{max}premiers. ».
Différences entre le mode XML et le mode HTML
Le comportement de l'évaluation s'adapte selon le type d'entrée sélectionné:
- En mode XML: L'outil applique rigoureusement les règles relatives aux espaces de noms (namespaces) XML. Les préfixes déclarés au sein de votre document XML peuvent être réutilisés directement dans votre expression XPath (par exemple,
//x:item). De même, pour les espaces de noms par défaut déclarés dans le document XML, un chemin simple comme//itemse conforme à la déclaration du document. - En mode HTML: L'outil se montre plus tolérant lors de l'analyse. Il permet à des chemins simples, tels que
//a, de cibler et de correspondre directement aux balises ordinaires du document.
Il est important de noter que cet outil de test local ne représente pas la structure en temps réel, le DOM rendu, ni les requêtes réseau des pages web publiées en ligne.
Confidentialité des données
La sécurité de vos données est prise en compte lors de l'utilisation de cet outil:
- Votre XML, votre HTML et votre XPath sont testés directement dans votre navigateur.
- Aucune donnée n'est envoyée ou téléchargée vers les serveurs de BroBroGo.
FAQ
Puis-je tester XPath sur du HTML autant que sur du XML?
Oui. Le mode XML garde les règles de namespaces XML. Le mode HTML est plus tolérant et permet à des chemins simples comme //a de trouver les balises ordinaires.
Comment fonctionnent les namespaces XML?
Les préfixes déclarés dans votre XML peuvent être utilisés dans le XPath, par exemple //x:item. Pour un namespace par défaut, //item suit aussi la déclaration du document.
Pourquoi une requête peut-elle expirer?
Les très grands documents et les expressions trop larges peuvent être coûteux à évaluer. L’outil arrête une exécution après 2 secondes pour que la page reste réactive; resserrez le chemin ou utilisez un exemple plus petit.