NodeIterator: Methode previousNode()

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 NodeIterator.previousNode()-Methode gibt den vorhergehenden Knoten in der durch den NodeIterator dargestellten Menge zurück und bewegt die Position des Iterators innerhalb der Menge rückwärts.

Diese Methode gibt null zurück, wenn der aktuelle Knoten der erste Knoten in der Menge ist.

In älteren Browsern, wie in älteren Versionen der Spezifikationen angegeben, kann die Methode die Ausnahme INVALID_STATE_ERR DOMException auslösen, wenn diese Methode nach der Methode NodeIterator.detach() aufgerufen wird. Aktuelle Browser werfen diese Ausnahme nie.

Syntax

js
previousNode()

Parameter

Keine.

Rückgabewert

Ein Node, der den Knoten vor dem aktuellen Knoten in der durch diesen NodeIterator dargestellten Menge repräsentiert, oder null, wenn der aktuelle Knoten der erste 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
previousNode = nodeIterator.previousNode(); // same result, since we backtracked to the previous node

Spezifikationen

Specification
DOM Standard
# dom-nodeiterator-previousnode

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch