XPathResult

XPathResult 接口表示在给定节点的上下文中评估 XPath 表达式生成的的结果。

由于 XPath 表达式可能产生各种结果类型,因此此接口可以确定并处理结果的类型和值。

实例属性

XPathResult.booleanValue 只读

如果resultTypeBOOLEAN_TYPE,则表示结果值的 boolean 值。

XPathResult.invalidIteratorState 只读

表示迭代器已失效。如果resultTypeUNORDERED_NODE_ITERATOR_TYPEORDERED_NODE_ITERATOR_TYPE 并且自返回此结果以来文档已被修改,则其值为 true

XPathResult.numberValue 只读

如果resultTypeNUMBER_TYPE,则表示结果值的 number 值。

XPathResult.resultType 只读

表示结果类型的 number 代码,由类型常量定义。

XPathResult.singleNodeValue 只读

表示单个节点结果值的 Node,可能为 null

XPathResult.snapshotLength 只读

结果快照中的节点数。

XPathResult.stringValue 只读

如果resultTypeSTRING_TYPE,则表示结果值的字符串。

实例方法

XPathResult.iterateNext()

如果结果是节点集,则此方法对其进行迭代并返回其中的下一个节点,如果不再有节点,则返回 null

XPathResult.snapshotItem()

返回快照集合中的一个项目,如果索引不在节点范围内,则返回 null。与迭代器结果不同,快照不会失效,但如果它被修改,则可能不对应于当前文档。

常量

结果类型定义常量 描述
ANY_TYPE 0 包含任何类型的结果集,这些类型自然地来自表达式的评估。请注意,如果结果是节点集,则 UNORDERED_NODE_ITERATOR_TYPE 始终是结果类型。
NUMBER_TYPE 1 包含单个数字的结果。例如,在使用 count() 函数的 XPath 表达式中很有用。
STRING_TYPE 2 包含单个字符串的结果。
BOOLEAN_TYPE 3 包含单个布尔值的结果。例如,在使用 not() 函数的 XPath 表达式中很有用。
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

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅