Qu’est-ce que XPath ?

XPath est un petit langage de requête qui permet d’extraire des parties d’un document XML. Une expression telle que //book/title parcourt l’arborescence des éléments du document et renvoie chaque titre contenu dans un livre, où qu’il se trouve. XPath est utilisé dans les feuilles de style XSLT, les schémas XML, les tests Selenium et Playwright, les extracteurs Web et la configuration de nombreux outils qui lisent du XML.

Comment utiliser le testeur

  1. Saisissez une expression XPath, par exemple //book[price > 15]/title.
  2. Collez votre XML en dessous.
  3. Les résultats sont mis à jour à mesure que vous saisissez du texte. Une erreur de saisie dans l’expression ou dans le XML indique le problème et, pour le XML, la ligne et la colonne où il se trouve.

Lire les résultats

  • Une expression qui sélectionne des nœuds affiche chaque correspondance dans l’ordre du document, avec son type : un élément apparaît sous forme de XML indenté, un attribut sous la forme name="value", et le texte, les CDATA et les commentaires sont affichés tels quels. Le champ Correspondances indique leur nombre, et son bouton de copie les copie toutes, une par ligne.
  • Une expression qui calcule une valeur, comme count(//book) ou contains(//title, 'Garden'), affiche son résultat unique : un nombre, une chaîne ou une valeur booléenne (true ou false).
  • Les espaces et sauts de ligne seuls, situés entre des éléments dans du XML indenté, sont signalés comme tels afin de les distinguer d’un résultat vide.

Espaces de noms

Les préfixes déclarés dans le XML, comme media dans xmlns:media="…", s’utilisent tels quels dans l’expression : //media:thumbnail.

Un espace de noms par défaut, déclaré comme xmlns="…" sans préfixe, est un piège courant. En XPath 1.0, un nom sans préfixe ne correspond qu’aux éléments qui n’appartiennent à aucun espace de noms. Ainsi, //entry ne renvoie rien dans un flux Atom. Le testeur attribue à chaque espace de noms par défaut le préfixe ns (puis ns2, ns3, et ainsi de suite), ce qui permet d’utiliser //ns:entry. Vous pouvez aussi sélectionner un élément par son seul nom avec //*[local-name()='entry']. Le tableau des préfixes d’espaces de noms répertorie tous les préfixes utilisables.

Exemples

Avec la bibliothèque de livres d’exemple :

  • //book/title sélectionne les trois éléments title.
  • //book[@genre='garden']/title/text() sélectionne le texte des titres des livres de jardinage.
  • //book/@id sélectionne les attributs id.
  • //book[price > 15]/title sélectionne les titres des livres dont le prix dépasse 15.
  • count(//book) renvoie 3.
  • sum(//price) renvoie 51.75.
  • string(//book[last()]/author) renvoie l’auteur du dernier livre.

Fonctionnement

Le XML est lu à l’aide de l’analyseur xmldom et l’expression est évaluée par la bibliothèque xpath, qui implémente XPath 1.0 avec toutes ses fonctions et tous ses axes. Les deux s’exécutent dans votre navigateur : le XML ne quitte donc jamais votre appareil.

Fonctionnalités

  • Expressions XPath 1.0 avec prédicats, axes et fonctions
  • Éléments, attributs, texte, commentaires et valeurs calculées
  • Préfixes d’espaces de noms automatiques, y compris pour un espace de noms par défaut
  • Messages d’erreur indiquant la ligne et la colonne d’une erreur dans le XML
  • Copier toutes les correspondances en une seule fois
  • Fonctionne dans votre navigateur