Vad är XPath?

XPath är ett litet frågespråk för att välja delar ur ett XML-dokument. Ett uttryck som //book/title går igenom dokumentets elementträd och returnerar alla titlar inuti en bok, oavsett var de finns. XPath används i XSLT-formatmallar, XML Schema, tester i Selenium och Playwright, webbskrapor och konfigurationen av många verktyg som läser XML.

Så använder du testverktyget

  1. Skriv ett XPath-uttryck, till exempel //book[price > 15]/title.
  2. Klistra in din XML nedanför.
  3. Resultaten uppdateras medan du skriver. Ett skrivfel i uttrycket eller XML-koden visar vad som gick fel och, för XML-koden, på vilken rad och i vilken kolumn felet inträffade.

Så läser du resultaten

  • Ett uttryck som väljer noder listar varje träff i dokumentordning, tillsammans med nodens typ: ett element visas som indenterad XML, ett attribut som name="value" och text, CDATA-avsnitt och kommentarer visas som text. Fältet Träffar räknar dem, och kopieringsknappen kopierar alla, en per rad.
  • Ett uttryck som beräknar något, till exempel count(//book) eller contains(//title, 'Garden'), visar ett enda värde: ett tal, en sträng eller ett booleskt värde (true eller false).
  • Text som bara består av blanksteg och radbrytningar och finns mellan element i indenterad XML märks ut så att du kan skilja den från ett tomt resultat.

Namnrymder

Prefix som deklareras i XML, till exempel media i xmlns:media="…", används oförändrade i uttrycket: //media:thumbnail.

En standardnamnrymd, som deklareras som xmlns="…" utan prefix, är det vanliga problemet. I XPath 1.0 matchar ett namn utan prefix bara element som inte tillhör någon namnrymd, så //entry hittar inget i ett Atom-flöde. Testverktyget ger varje standardnamnrymd prefixet ns (därefter ns2, ns3 och så vidare), så //ns:entry fungerar. Du kan också matcha ett element enbart med dess namn med //*[local-name()='entry']. Tabellen med namnrymdsprefix listar alla prefix som du kan använda.

Exempel

Med exempelsamlingen av böcker:

  • //book/title väljer de tre titelelementen.
  • //book[@genre='garden']/title/text() väljer titlarna på trädgårdsböckerna som text.
  • //book/@id väljer id-attributen.
  • //book[price > 15]/title väljer titlarna på böcker som kostar mer än 15.
  • count(//book) returnerar 3.
  • sum(//price) returnerar 51.75.
  • string(//book[last()]/author) returnerar författaren till den sista boken.

Så fungerar det

XML-koden läses med tolken xmldom och uttrycket utvärderas av biblioteket xpath, som implementerar XPath 1.0 med alla dess funktioner och axlar. Båda körs i din webbläsare, så XML-koden lämnar aldrig din enhet.

Funktioner

  • XPath 1.0-uttryck med predikat, axlar och funktioner
  • Element, attribut, text, kommentarer och beräknade värden
  • Automatiska namnrymdsprefix, inklusive ett för en standardnamnrymd
  • Felmeddelanden med rad och kolumn för ett fel i XML-koden
  • Kopiera alla träffar på en gång
  • Körs i din webbläsare