XPathResult: iterateNext() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

XPathResult 介面的 iterateNext() 方法用於遍歷節點集結果,並從中返回下一個節點。如果已無更多節點,則返回 null

語法

js
iterateNext()

引數

無。

返回值

XPathResult 節點集中的下一個 Node

異常

TYPE_ERR

如果 XPathResult.resultType 不是 UNORDERED_NODE_ITERATOR_TYPEORDERED_NODE_ITERATOR_TYPE,則會丟擲型別為 TYPE_ERRDOMException

INVALID_STATE_ERR

如果自返回結果以來文件已被修改,則會丟擲型別為 INVALID_STATE_ERRDOMException

示例

以下示例展示了 iterateNext() 方法的用法。

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.ANY_TYPE,
  null,
);
let node = null;
const tagNames = [];
while ((node = result.iterateNext())) {
  tagNames.push(node.localName);
}
document.querySelector("output").textContent = tagNames.join(", ");

結果

規範

規範
DOM
# dom-xpathresult-iteratenext

瀏覽器相容性