XPathResult
Базовая Широко доступная
Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.
Интерфейс XPathResult представляет результаты, полученные при оценке выражения XPath в контексте заданного узла.
Поскольку выражения XPath могут давать различные типы результатов, этот интерфейс позволяет определить и обработать тип и значение результата.
Свойства экземпляра
-
XPathResult.booleanValueТолько для чтения -
Значение
boolean, представляющее результат, еслиresultTypeимеет типBOOLEAN_TYPE. -
XPathResult.invalidIteratorStateТолько для чтения -
Указывает, что итератор стал недопустимым. Он равен
true, еслиresultTypeимеет типUNORDERED_NODE_ITERATOR_TYPEилиORDERED_NODE_ITERATOR_TYPE, и документ был изменён с момента возвращения этого результата. -
XPathResult.numberValueТолько для чтения -
Значение
number, представляющее результат, еслиresultTypeимеет типNUMBER_TYPE. -
XPathResult.resultTypeТолько для чтения -
Код
number, представляющий тип результата, как определено в константах типа. -
XPathResult.singleNodeValueТолько для чтения -
Узел
Node, представляющий значение единственного узла результата, который может бытьnull. -
XPathResult.snapshotLengthТолько для чтения -
Количество узлов в снимке результата.
-
XPathResult.stringValueТолько для чтения -
Строка, представляющая значение результата, если
resultTypeимеет типSTRING_TYPE.
Методы экземпляра
XPathResult.iterateNext()-
Если результат — множество узлов, этот метод итерируется по нему и возвращает следующий узел или
null, если больше узлов нет. XPathResult.snapshotItem()-
Возвращает элемент набора снимков или
null, если индекс выходит за пределы диапазона узлов. В отличие от итератора, снимок не становится недействительным, но может не соответствовать текущему документу, если он был изменён.
Константы
| Константа типа результата | Значение | Описание |
|---|---|---|
ANY_TYPE | 0 | Результат, содержащий тип, который естественным образом получается при оценке выражения. Обратите внимание, что если результат является набором узлов, то UNORDERED_NODE_ITERATOR_TYPE всегда является результатом типа. |
NUMBER_TYPE | 1 | Результат, содержащий единственное число. Это полезно, например, в выражении XPath, использующем функцию count(). |
STRING_TYPE | 2 | Результат, содержащий единственную строку. |
BOOLEAN_TYPE | 3 | Результат, содержащий единственное булевое значение. Это полезно, например, в выражении XPath, использующем функцию not(). |
UNORDERED_NODE_ITERATOR_TYPE | 4 | Результат, содержащий набор узлов, соответствующих выражению. Узлы могут не быть в том же порядке, в котором они появляются в документе. |
ORDERED_NODE_ITERATOR_TYPE | 5 | Результат, содержащий набор узлов, соответствующих выражению. Узлы в наборе результатов расположены в том же порядке, в котором они появляются в документе. |
UNORDERED_NODE_SNAPSHOT_TYPE | 6 | Результат, содержащий набор узлов, содержащих снимки всех узлов, соответствующих выражению. Узлы могут не быть в том же порядке, в котором они появляются в документе. |
ORDERED_NODE_SNAPSHOT_TYPE | 7 | Результат, содержащий набор узлов, содержащих снимки всех узлов, соответствующих выражению. Узлы в наборе результатов расположены в том же порядке, в котором они появляются в документе. |
ANY_UNORDERED_NODE_TYPE | 8 | Результат, содержащий набор узлов, содержащий любой единственный узел, соответствующий выражению. Узел не обязательно является первым узлом в документе, соответствующим выражению. |
FIRST_ORDERED_NODE_TYPE | 9 | Результат, содержащий набор узлов, содержащий первый узел в документе, соответствующий выражению. |
Спецификации
| Спецификация |
|---|
| DOM # interface-xpathresult |
Совместимость браузеров
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
XPathResult |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
booleanValue |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
invalidIteratorState |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | ≤37 |
iterateNext |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
numberValue |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
resultType |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | ≤37 |
singleNodeValue |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
snapshotItem |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
snapshotLength |
1 | 12 | 1 | ≤12.1 | 3 | 18 | 4 | ≤12.1 | 1 | 1.0 | 4.4 |
stringValue |
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
