XPathResult: свойство singleNodeValue

Базовая линия Широко поддерживается

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Только для чтения singleNodeValue свойство интерфейса XPathResult возвращает значение узла Node или null в случае, если не было найдено ни одного узла, или результат с XPathResult.resultType являющимся ANY_UNORDERED_NODE_TYPE или FIRST_ORDERED_NODE_TYPE.

Значение

Возвращаемое значение — это значение узла Node возвращённого XPathResult методом Document.evaluate().

Исключения

TYPE_ERR

В случае, если XPathResult.resultType не является ANY_UNORDERED_NODE_TYPE или FIRST_ORDERED_NODE_TYPE, выбрасывается исключение XPathException типа TYPE_ERR.

Примеры

Следующий пример демонстрирует использование свойства singleNodeValue.

HTML

<div>XPath example</div>
<div>
  Tag name of the element having the text content 'XPath example':
  <output></output>
</div>

JavaScript

const xpath = "//*[text()='XPath example']";
const result = document.evaluate(
  xpath,
  document,
  null,
  XPathResult.FIRST_ORDERED_NODE_TYPE,
  null,
);
document.querySelector("output").textContent = result.singleNodeValue.localName;

Результат

Спецификации

Спецификация
DOM # dom-xpathresult-singlenodevalue

Совместимость браузеров

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`singleNodeValue`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XPathResult/singleNodeValue