previousNode

Summary

The NodeIterator.previousNode() method returns the previous node in the set represented by the NodeIterator and moves the position of the iterator backwards within the set.

Method of dom/NodeIteratordom/NodeIterator

Syntax

var object = object.previousNode(/* see parameter list */);

Parameters

oNode

Data-type

any

Object containing the previous node in the list.

Return Value

Returns an object of type DOM NodeDOM Node

Type: HRESULT

This method can return one of these values.

This method returns null when the current node is the first node in the set.

Node

Object containing the previous node in the list.

Examples

var nodeIterator = document.createNodeIterator(
    document.body,
    NodeFilter.SHOW_ELEMENT,
    { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } },
    false // this optional argument is not used any more
);
currentNode = nodeIterator.nextNode(); // returns the next node
previousNode = nodeIterator.previousNode(); // same result, since we backtracked to the previous nod

Notes

In old browsers, as specified in old versions of the specifications, the method may throws the INVALID_STATE_ERR DOMException if this method is called after the NodeIterator.detach()method. Recent browsers never throw.

Syntax

node = nodeIterator.previousNode();

Standards information

• Document Object Model (DOM) Level 2 Traversal and Range Specification, Section 1.2

Related specifications

DOM

Living Standard

Attributions

• Mozilla Developer Network : [NodeIterator.previousNode Article]

• Microsoft Developer Network: [previousNode Method Article]