NodeIterator.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.

La méthode NodeIterator.previousNode() renvoie le noeud précédent dans l'ensemble représenté par le NodeIterator et déplace la position de l'itérateur vers l'arrière à l'intérieur de cet ensemble.

Cette méthode renvoie null si le noeud courant est le premier noeud dans l'ensemble.

Dans les navigateurs anciens, comme spécifié dans les anciennes version des spécifications, la méthode pouvait déclencher une INVALID_STATE_ERR DOMException si elle était appelée après la méthode NodeIterator.detach(). Les navigateurs récents ne lancent rien.

Syntaxe

js
node = nodeIterator.previousNode();

Exemple

js
var nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode: function (node) {
      return NodeFilter.FILTER_ACCEPT;
    },
  },
  false, // cet argument facultatif n'est plus utilisé
);
currentNode = nodeIterator.nextNode(); // renvoie le noeud suivant
previousNode = nodeIterator.previousNode(); // même résultat, puisque nous sommes retournés au noeud précédent

Spécifications

Specification
DOM Standard
# dom-nodeiterator-previousnode

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi