Czym jest XPath?

XPath to niewielki język zapytań służący do wybierania fragmentów dokumentu XML. Wyrażenie takie jak //book/title przechodzi przez drzewo elementów dokumentu i zwraca wszystkie elementy title znajdujące się w elementach book, niezależnie od ich położenia. XPath jest używany w arkuszach stylów XSLT, XML Schema, testach Selenium i Playwright, scraperach internetowych oraz konfiguracji wielu narzędzi odczytujących XML.

Jak korzystać z testera

  1. Wpisz wyrażenie XPath, na przykład //book[price > 15]/title.
  2. Wklej poniżej kod XML.
  3. Wyniki aktualizują się podczas pisania. Błąd w wyrażeniu lub kodzie XML wyświetli informację o tym, co poszło nie tak. W przypadku XML zobaczysz także numer wiersza i kolumny, w której wystąpił błąd.

Odczytywanie wyników

  • Wyrażenie wybierające węzły wyświetla wszystkie dopasowania w kolejności występowania w dokumencie, wraz z ich typem: element jest wyświetlany jako wcięty kod XML, atrybut jako name="value", a tekst, sekcja CDATA i komentarze — jako tekst. Pole „Dopasowania” pokazuje ich liczbę, a przycisk kopiowania kopiuje wszystkie, po jednym w wierszu.
  • Wyrażenie obliczające jakąś wartość, na przykład count(//book) lub contains(//title, 'Garden'), wyświetla pojedynczy wynik: liczbę, ciąg znaków lub wartość logiczną (true albo false).
  • Tekst składający się wyłącznie ze spacji i znaków nowego wiersza, znajdujący się między elementami w kodzie XML z wcięciami, jest odpowiednio oznaczony, aby można go było odróżnić od pustego wyniku.

Przestrzenie nazw

Prefiksy zadeklarowane w kodzie XML, takie jak media w xmlns:media="…", są używane w wyrażeniu bez zmian: //media:thumbnail.

Domyślna przestrzeń nazw, zadeklarowana jako xmlns="…" bez prefiksu, często sprawia problemy. W XPath 1.0 nazwa bez prefiksu dopasowuje wyłącznie elementy, które nie należą do żadnej przestrzeni nazw, więc wyrażenie //entry nie zwróci wyników w pliku Atom. Tester przypisuje każdej domyślnej przestrzeni nazw prefiks ns (a kolejnym ns2, ns3 itd.), dzięki czemu można użyć wyrażenia //ns:entry. Można też dopasować element wyłącznie na podstawie jego nazwy, używając wyrażenia //*[local-name()='entry']. Tabela prefiksów przestrzeni nazw zawiera wszystkie prefiksy, których można użyć.

Przykłady

Dla przykładowego zbioru książek:

  • //book/title wybiera trzy elementy title.
  • //book[@genre='garden']/title/text() wybiera tekst tytułów książek o tematyce ogrodniczej.
  • //book/@id wybiera atrybuty id.
  • //book[price > 15]/title wybiera tytuły książek droższych niż 15.
  • count(//book) zwraca 3.
  • sum(//price) zwraca 51.75.
  • string(//book[last()]/author) zwraca nazwisko autora ostatniej książki.

Jak to działa

Kod XML jest odczytywany za pomocą parsera xmldom, a wyrażenie jest obliczane przez bibliotekę xpath, która implementuje XPath 1.0 wraz ze wszystkimi jego funkcjami i osiami. Oba narzędzia działają w przeglądarce, więc kod XML nigdy nie opuszcza Twojego urządzenia.

Funkcje

  • Wyrażenia XPath 1.0 z predykatami, osiami i funkcjami
  • Elementy, atrybuty, tekst, komentarze i obliczone wartości
  • Automatyczne prefiksy przestrzeni nazw, w tym prefiks dla domyślnej przestrzeni nazw
  • Komunikaty o błędach zawierające numer wiersza i kolumny, w których wystąpił błąd w kodzie XML
  • Kopiowanie wszystkich dopasowań jednocześnie
  • Działa w przeglądarce