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 貢獻者修改。