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 July 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

js
nextNode()

Parameter

Keine.

Rückgabewert

Ein Node, der den Knoten nach dem aktuellen Knoten in der durch diesen NodeIterator dargestellten Menge repräsentiert, oder null, wenn der aktuelle Knoten der letzte Knoten in der Menge ist.

Beispiele

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

Spezifikationen

Specification
DOM Standard
# dom-nodeiterator-nextnode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch