XPathResult

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

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

由于 XPath 表达式可以产生各种结果类型，此接口使得确定和处理结果的类型和值成为可能。

实例属性

XPathResult.booleanValue 只读: 当 resultType 为 BOOLEAN_TYPE 时，表示结果值的布尔值。
XPathResult.invalidIteratorState 只读: 表示迭代器已失效。如果 resultType 是 UNORDERED_NODE_ITERATOR_TYPE 或 ORDERED_NODE_ITERATOR_TYPE，并且自返回此结果以来文档已被修改，则此值为 true。
XPathResult.numberValue 只读: 当 resultType 为 NUMBER_TYPE 时，表示结果值的数字。
XPathResult.resultType 只读: 表示结果类型的数字代码，由类型常量定义。
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

此页面最后修改于 ⁨2025年9月25日⁩，由 MDN 贡献者修改。