NodeIterator: Methode nextNode()

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 Methode NodeIterator.nextNode() gibt den nächsten Knoten in der durch den NodeIterator dargestellten Menge zurück und verschiebt die Position des Iterators innerhalb der Menge. Der erste Aufruf von nextNode() gibt den ersten Knoten in der Menge zurück.

Diese Methode gibt null zurück, wenn keine Knoten mehr in der Menge vorhanden sind.

In alten Browsern, wie in früheren Versionen der Spezifikationen festgelegt, kann die Methode den INVALID_STATE_ERR DOMException auslösen, wenn diese Methode nach der Methode NodeIterator.detach() aufgerufen wird. Aktuelle Browser werfen diesen Fehler jedoch nie.

Syntax

nextNode()

const nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode(node) {
      return NodeFilter.FILTER_ACCEPT;
    },
  },
);
currentNode = nodeIterator.nextNode(); // returns the next node