XPathResult
XPathResult
接口表示在给定节点的上下文中评估 XPath 表达式生成的的结果。
由于 XPath 表达式可能产生各种结果类型,因此此接口可以确定并处理结果的类型和值。
实例属性
XPathResult.booleanValue
只读-
如果
resultType
为BOOLEAN_TYPE
,则表示结果值的boolean
值。 XPathResult.invalidIteratorState
只读-
表示迭代器已失效。如果
resultType
为UNORDERED_NODE_ITERATOR_TYPE
或ORDERED_NODE_ITERATOR_TYPE
并且自返回此结果以来文档已被修改,则其值为true
。 XPathResult.numberValue
只读-
如果
resultType
为NUMBER_TYPE
,则表示结果值的number
值。 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 |
包含单个数字的结果。例如,在使用 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 的浏览器中加载。