NodeIterator
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
TheNodeIterator interface represents an iterator to traverse nodes of a DOM subtree in document order.
ANodeIterator can be created using theDocument.createNodeIterator() method, as follows:
const nodeIterator = document.createNodeIterator(root, whatToShow, filter);In this article
Instance properties
This interface doesn't inherit any property.
NodeIterator.rootRead onlyReturns a
Noderepresenting the root node, as specified when theNodeIteratorwas created.NodeIterator.whatToShowRead onlyReturns an
unsigned longbitmask that describes the types ofNodeto be matched. Non-matching nodes are skipped, but relevant child nodes may be included.NodeIterator.filterRead onlyReturns a
NodeFilterused to select the relevant nodes.NodeIterator.referenceNodeRead onlyReturns the
Nodeto which the iterator is anchored.NodeIterator.pointerBeforeReferenceNodeRead onlyReturns a boolean indicating whether or not the
NodeIteratoris anchoredbefore theNodeIterator.referenceNode. Iffalse, it indicates that the iterator is anchoredafter the reference node.
Instance methods
This interface doesn't inherit any method.
NodeIterator.detach()DeprecatedThis is a legacy method, and no longer has any effect. Previously it served to mark a
NodeIteratoras disposed, so it could be reclaimed by garbage collection.NodeIterator.previousNode()Returns the previous
Nodein the document, ornullif there are none.NodeIterator.nextNode()Returns the next
Nodein the document, ornullif there are none.
Specifications
| Specification |
|---|
| DOM> # interface-nodeiterator> |
Browser compatibility
See also
- The creator method:
Document.createNodeIterator(). - Related interface:
TreeWalker