XPathResult:snapshotItem() 方法

Baseline 已广泛支持

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

snapshotItem() 方法是 XPathResult 接口的一个方法,它返回快照集合中的一个项,如果索引超出了节点的范围,则返回 null。与迭代器结果不同,快照不会失效,但如果文档被修改,它可能不再对应于当前文档。

语法

js
snapshotItem(i)

参数

i

一个数字,表示项的索引。

返回值

位于 XPathResult 节点集中给定索引处的 Node

异常

TYPE_ERR

如果 XPathResult.resultType 不是 UNORDERED_NODE_SNAPSHOT_TYPEORDERED_NODE_SNAPSHOT_TYPE,则会抛出类型为 TYPE_ERRDOMException

示例

以下示例演示了 snapshotItem() 方法的用法。

HTML

html
<div>XPath example</div>
<div>Tag names of the matched nodes: <output></output></div>

JavaScript

js
const xpath = "//div";
const result = document.evaluate(
  xpath,
  document,
  null,
  XPathResult.ORDERED_NODE_SNAPSHOT_TYPE,
  null,
);
let node = null;
const tagNames = [];
for (let i = 0; i < result.snapshotLength; i++) {
  node = result.snapshotItem(i);
  tagNames.push(node.localName);
}
document.querySelector("output").textContent = tagNames.join(", ");

结果

规范

规范
DOM
# dom-xpathresult-snapshotitem-index-index

浏览器兼容性