Che cos’è XPath?

XPath è un piccolo linguaggio di query che permette di selezionare parti di un documento XML. Un’espressione come //book/title attraversa l’albero degli elementi del documento e restituisce ogni titolo contenuto in un libro, ovunque si trovi. XPath viene usato nei fogli di stile XSLT, in XML Schema, nei test con Selenium e Playwright, nei web scraper e nella configurazione di molti strumenti che leggono XML.

Come usare lo strumento di test

  1. Digita un’espressione XPath, ad esempio //book[price > 15]/title.
  2. Incolla il tuo XML sotto l’espressione.
  3. I risultati si aggiornano mentre digiti. Un errore di battitura nell’espressione o nell’XML mostra cosa non ha funzionato e, per l’XML, la riga e la colonna in cui si è verificato.

Come leggere i risultati

  • Un’espressione che seleziona nodi elenca ogni corrispondenza nell’ordine del documento, indicandone il tipo: un elemento viene mostrato come XML rientrato, un attributo come name="value" e il testo, i CDATA e i commenti come testo. Il campo Corrispondenze ne indica il numero e il relativo pulsante di copia le copia tutte, una per riga.
  • Un’espressione che calcola un valore, come count(//book) o contains(//title, 'Garden'), mostra il suo singolo risultato: un numero, una stringa o un valore booleano (true o false).
  • Il testo composto solo da spazi e interruzioni di riga, presente tra gli elementi nell’XML rientrato, viene etichettato come tale, così puoi distinguerlo da un risultato vuoto.

Spazi dei nomi

I prefissi dichiarati nell’XML, come media in xmlns:media="…", si usano nell’espressione così come sono: //media:thumbnail.

Uno spazio dei nomi predefinito, dichiarato come xmlns="…" senza prefisso, è il tipico ostacolo. In XPath 1.0, un nome senza prefisso corrisponde solo agli elementi che non appartengono ad alcuno spazio dei nomi, quindi //entry non trova nulla in un feed Atom. Lo strumento assegna a ogni spazio dei nomi predefinito il prefisso ns (poi ns2, ns3 e così via), quindi //ns:entry funziona. Puoi anche selezionare un elemento solo in base al suo nome con //*[local-name()='entry']. La tabella dei prefissi degli spazi dei nomi elenca tutti i prefissi utilizzabili.

Esempi

Con la raccolta di libri di esempio:

  • //book/title seleziona i tre elementi title.
  • //book[@genre='garden']/title/text() seleziona come testo i titoli dei libri di giardinaggio.
  • //book/@id seleziona gli attributi id.
  • //book[price > 15]/title seleziona i titoli dei libri che costano più di 15.
  • count(//book) restituisce 3.
  • sum(//price) restituisce 51.75.
  • string(//book[last()]/author) restituisce l’autore dell’ultimo libro.

Come funziona

L’XML viene letto con il parser xmldom e l’espressione viene valutata dalla libreria xpath, che implementa XPath 1.0 con tutte le sue funzioni e i suoi assi. Entrambi vengono eseguiti nel browser, quindi l’XML non lascia mai il tuo dispositivo.

Funzionalità

  • Espressioni XPath 1.0 con predicati, assi e funzioni
  • Elementi, attributi, testo, commenti e valori calcolati
  • Prefissi degli spazi dei nomi assegnati automaticamente, incluso uno per lo spazio dei nomi predefinito
  • Messaggi di errore con la riga e la colonna dell’errore nell’XML
  • Copia di tutte le corrispondenze in una volta sola
  • Funziona nel browser