XPathResult: iterateNext()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die iterateNext()-Methode des XPathResult-Interfaces iteriert über ein Knotensatz-Ergebnis und gibt den nächsten Knoten daraus zurück oder null, wenn keine weiteren Knoten vorhanden sind.
Syntax
iterateNext()
Parameter
Keine.
Rückgabewert
Der nächste Node innerhalb des Knotensatzes des XPathResult.
Ausnahmen
TYPE_ERR
Wenn XPathResult.resultType nicht UNORDERED_NODE_ITERATOR_TYPE oder ORDERED_NODE_ITERATOR_TYPE ist, wird ein DOMException vom Typ TYPE_ERR ausgelöst.
INVALID_STATE_ERR
Wenn das Dokument seit der Rückgabe des Ergebnisses verändert wurde, wird ein DOMException vom Typ INVALID_STATE_ERR ausgelöst.
Beispiele
Das folgende Beispiel zeigt die Verwendung der iterateNext()-Methode.
HTML
<div>XPath example</div>
<div>Tag names of the matched nodes: <output></output></div>
JavaScript
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(", ");
Ergebnis
Spezifikationen
| Specification |
|---|
| DOM # dom-xpathresult-iteratenext |
Browser-Kompatibilität
Loading…