Back to Content

TreeWalker: nextNode() method

files/en-us/web/api/treewalker/nextnode/index.md

latest841 B
Original Source

{{ APIRef("DOM") }}

The TreeWalker.nextNode() method moves the current {{domxref("Node")}} to the next visible node in the document order, and returns the found node. If no such node exists, it returns null and the current node is not changed.

Syntax

js-nolint
nextNode()

Parameters

None.

Return value

A {{domxref("Node")}} object or null.

Examples

js
const treeWalker = document.createTreeWalker(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode(node) {
      return NodeFilter.FILTER_ACCEPT;
    },
  },
  false,
);
const node = treeWalker.nextNode(); // returns the first child of root, as it is the next node in document order

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • The {{domxref("TreeWalker")}} interface it belongs to.