XPath nedir?

XPath, bir XML belgesinin belirli bölümlerini seçmek için kullanılan küçük bir sorgu dilidir. //book/title gibi bir ifade, öğeler ağacını tarar ve nerede bulunurlarsa bulunsunlar, bir book öğesinin içindeki tüm title öğelerini döndürür. XPath; XSLT stil sayfalarında, XML Schema'da, Selenium ve Playwright testlerinde, web kazıyıcılarında ve XML okuyan birçok aracın yapılandırmasında kullanılır.

Test aracı nasıl kullanılır?

  1. //book[price > 15]/title gibi bir XPath ifadesi yazın.
  2. XML'inizi altındaki alana yapıştırın.
  3. Siz yazarken sonuçlar güncellenir. İfadede veya XML'de yazım hatası varsa neyin yanlış olduğu gösterilir; XML'deki hatalarda ayrıca hatanın bulunduğu satır ve sütun da belirtilir.

Sonuçları okuma

  • Düğümleri seçen bir ifade, her eşleşmeyi belge sırasına göre listeler ve türünü belirtir: bir öğe girintili XML olarak, bir öznitelik name="value" biçiminde, metin, CDATA ve yorumlar ise kendi metinleri olarak gösterilir. Eşleşmeler alanında eşleşme sayısı gösterilir; yanındaki kopyalama düğmesi tüm eşleşmeleri, her birini ayrı satıra yazarak kopyalar.
  • count(//book) veya contains(//title, 'Garden') gibi bir değer hesaplayan ifade, tek bir sonuç gösterir: sayı, dize veya mantıksal değer (true ya da false).
  • Girintili XML'de öğelerin arasında bulunan ve yalnızca boşluklardan ve satır sonlarından oluşan metin, boş bir sonuçtan ayırt edilebilmesi için ayrıca etiketlenir.

Ad alanları

XML'de bildirilen media gibi önekler, xmlns:media="…" içinde olduğu gibi, ifadede de aynı şekilde kullanılır: //media:thumbnail.

Öneksiz olarak xmlns="…" biçiminde bildirilen varsayılan ad alanı, en sık karşılaşılan sorunlardan biridir. XPath 1.0'da öneksiz bir ad yalnızca hiçbir ad alanında olmayan öğelerle eşleşir; bu nedenle //entry bir Atom akışında sonuç bulamaz. Test aracı her varsayılan ad alanına ns (sonrakilere ns2, ns3) önekini verir; böylece //ns:entry işe yarar. Bir öğeyi yalnızca adına göre //*[local-name()='entry'] biçiminde de eşleştirebilirsiniz. Ad alanı önekleri tablosunda kullanabileceğiniz tüm önekler listelenir.

Örnekler

Örnek kitaplık kullanıldığında:

  • //book/title üç title öğesini seçer.
  • //book[@genre='garden']/title/text() bahçe kitaplarının başlıklarını metin olarak seçer.
  • //book/@id id özniteliklerini seçer.
  • //book[price > 15]/title fiyatı 15'ten yüksek olan kitapların başlıklarını seçer.
  • count(//book) 3 değerini döndürür.
  • sum(//price) 51.75 değerini döndürür.
  • string(//book[last()]/author) son kitabın yazarını döndürür.

Nasıl çalışır?

XML, xmldom ayrıştırıcısıyla okunur; ifade ise tüm işlev ve eksenleriyle XPath 1.0'ı uygulayan xpath kütüphanesi tarafından değerlendirilir. Her ikisi de tarayıcınızda çalışır; bu nedenle XML cihazınızdan dışarı çıkmaz.

Özellikler

  • Koşul belirteçleri, eksenler ve işlevler içeren XPath 1.0 ifadeleri
  • Öğeler, öznitelikler, metinler, yorumlar ve hesaplanan değerler
  • Varsayılan ad alanı için de bir önek içeren otomatik ad alanı önekleri
  • XML'deki hataların satır ve sütununu belirten hata mesajları
  • Tüm eşleşmeleri tek seferde kopyalama
  • Tarayıcınızda çalışır