ما هو XPath؟

XPath هي لغة استعلام صغيرة لاستخراج أجزاء من مستند XML. يتنقل تعبير مثل //book/title عبر شجرة عناصر المستند، ويُرجع كل عنوان داخل كتاب، أينما كان موضعه. يُستخدم XPath في أوراق أنماط XSLT، ومخطط XML، واختبارات Selenium وPlaywright، وأدوات استخراج البيانات من الويب، وإعدادات كثير من الأدوات التي تقرأ XML.

كيفية استخدام أداة الاختبار

  1. اكتب تعبير XPath، مثل //book[price > 15]/title.
  2. الصق مستند XML أسفله.
  3. تتحدّث النتائج أثناء الكتابة. إذا كان هناك خطأ في التعبير أو مستند XML، ستظهر تفاصيل المشكلة، ومع مستند XML سيظهر رقم السطر والعمود اللذان وقع فيهما الخطأ.

قراءة النتائج

  • إذا كان التعبير يحدّد عُقدًا، فستُدرج كل نتيجة مطابقة حسب ترتيبها في المستند، مع نوعها: يظهر العنصر بصيغة XML مزاحة إلى الداخل، وتظهر السمة بصيغة name="value"، أما النصوص وCDATA والتعليقات فتظهر كنصوصها. يحصي حقل «التطابقات» النتائج، وينسخ زر النسخ جميعها، كل نتيجة في سطر.
  • إذا كان التعبير يحسب قيمة، مثل count(//book) أو contains(//title, 'Garden')، فستظهر قيمته المفردة: رقم أو سلسلة نصية أو قيمة منطقية (true أو false).
  • تُصنّف النصوص التي لا تحتوي إلا على مسافات وفواصل أسطر، والواقعة بين العناصر في مستند XML ذي التنسيق المزاح إلى الداخل، لتتمكن من تمييزها عن النتيجة الفارغة.

مساحات الأسماء

تعمل البادئات التي يعرّفها مستند XML، مثل media في xmlns:media="…"، في التعبير كما هي: //media:thumbnail.

أما مساحة الاسم الافتراضية، التي تُعرّف بصيغة xmlns="…" من دون بادئة، فهي العقبة الشائعة. في XPath 1.0، لا يطابق الاسم الذي لا بادئة له إلا العناصر التي لا تنتمي إلى أي مساحة أسماء؛ لذلك لا يُرجع //entry أي نتائج في موجز Atom. تمنح أداة الاختبار كل مساحة أسماء افتراضية البادئة ns (ثم ns2 وns3 للمزيد)، لذا يعمل //ns:entry. ويمكنك أيضًا مطابقة عنصر باسمه وحده باستخدام //*[local-name()='entry']. يسرد جدول بادئات مساحات الأسماء كل البادئات التي يمكنك استخدامها.

أمثلة

باستخدام مكتبة الكتب النموذجية:

  • يحدّد //book/title عناصر العنوان الثلاثة.
  • يحدّد //book[@genre='garden']/title/text() عناوين كتب الحدائق كنص.
  • يحدّد //book/@id سمات المعرّف.
  • يحدّد //book[price > 15]/title عناوين الكتب التي يزيد سعرها على 15.
  • تُرجع count(//book) القيمة 3.
  • تُرجع sum(//price) القيمة 51.75.
  • تُرجع string(//book[last()]/author) اسم مؤلف الكتاب الأخير.

آلية العمل

تُقرأ بيانات XML باستخدام محلّل xmldom، ويُقيَّم التعبير بواسطة مكتبة xpath، التي تنفّذ XPath 1.0 بجميع دواله ومحاوره. يعمل كلاهما في متصفحك، لذا لا تغادر بيانات XML جهازك.

الميزات

  • تعبيرات XPath 1.0 مع الشروط والمحاور والدوال
  • العناصر والسمات والنصوص والتعليقات والقيم المحسوبة
  • بادئات تلقائية لمساحات الأسماء، بما في ذلك بادئة لمساحة الاسم الافتراضية
  • رسائل خطأ تتضمن رقم السطر والعمود اللذين وقع فيهما الخطأ في مستند XML
  • نسخ كل النتائج المطابقة دفعة واحدة
  • يعمل في متصفحك