XPathResult: iterateNext()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
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
| Spezifikation |
|---|
| DOM # dom-xpathresult-iteratenext |