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…