The iterateNext()
method of the XPathResult
interface iterates over a node set result and returns the next node from it or null
if there are no more nodes.
XPathResult.iterateNext()
Syntax
iterateNext()
Return value
The next Node
within the node set of the XPathResult
.
Exceptions
TYPE_ERR
In case XPathResult.resultType
is not UNORDERED_NODE_ITERATOR_TYPE
or ORDERED_NODE_ITERATOR_TYPE
, an XPathException
of type TYPE_ERR
is thrown.
INVALID_STATE_ERR
If the document is mutated since the result was returned, an XPathException
of type INVALID_STATE_ERR
is thrown.
Examples
The following example shows the use of the iterateNext()
method.
HTML
<div>XPath example</div> <div>Tag names of the matched nodes: <output></output></div>
JavaScript
var xpath = "//div"; var result = document.evaluate(xpath, document, null, XPathResult.ANY_TYPE, null); var node = null; var tagNames = []; while(node = result.iterateNext()) { tagNames.push(node.localName); } document.querySelector("output").textContent = tagNames.join(", ");
Result
Specifications
Specification |
---|
DOM Standard # dom-xpathresult-iteratenext |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
iterateNext |
1
|
12
|
1
|
No
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/XPathResult/iterateNext