Что такое XPath?

XPath — это небольшой язык запросов для выбора частей XML-документа. Выражение, например //book/title, проходит по дереву элементов документа и возвращает каждый элемент title внутри book, где бы он ни находился. XPath используется в таблицах стилей XSLT, XML Schema, тестах 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 выбирает три элемента title.
  • //book[@genre='garden']/title/text() выбирает текст заголовков книг о садоводстве.
  • //book/@id выбирает атрибуты 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
  • Копирование всех совпадений одним нажатием
  • Работает в браузере