Документ: метод createNodeIterator()

Метод Document.createNodeIterator() возвращает новый объект NodeIterator.

root

Узловой элемент, с которого начинается обход NodeIterator.

whatToShow Необязательно

Необязательный unsigned long маской, созданной путем объединения константных свойств NodeFilter. Это удобный способ фильтрации узлов определенного типа. По умолчанию используется 0xFFFFFFFF, представляющая константу SHOW_ALL.

Константа	Числовое значение	Описание
NodeFilter.SHOW_ALL	4294967295 (максимальное значение unsigned long)	Отображает все узлы.
NodeFilter.SHOW_ATTRIBUTE Устаревший	2	Отображает узлы атрибутов Attr. Это имеет смысл только при создании TreeWalker с узлом Attr в качестве корневого. В этом случае это означает, что узел атрибута будет отображаться первым в итерации или обходе. Поскольку атрибуты никогда не являются дочерними узлами других узлов, они не отображаются при обходе по дереву документа.
NodeFilter.SHOW_CDATA_SECTION Устаревший	8	Отображает узлы CDATASection.
NodeFilter.SHOW_COMMENT	128	Отображает узлы Comment.
NodeFilter.SHOW_DOCUMENT	256	Отображает узлы Document.
NodeFilter.SHOW_DOCUMENT_FRAGMENT	1024	Отображает узлы DocumentFragment.
NodeFilter.SHOW_DOCUMENT_TYPE	512	Отображает узлы DocumentType.
NodeFilter.SHOW_ELEMENT	1	Отображает узлы Element.
NodeFilter.SHOW_ENTITY Устаревший	32	Устаревшее, больше не используется.
NodeFilter.SHOW_ENTITY_REFERENCE Устаревший	16	Устаревшее, больше не используется.
NodeFilter.SHOW_NOTATION Устаревший	2048	Устаревшее, больше не используется.
NodeFilter.SHOW_PROCESSING_INSTRUCTION	64	Отображает узлы ProcessingInstruction.
NodeFilter.SHOW_TEXT	4	Отображает узлы Text.

filter Необязательно

Функция обратного вызова или объект с методом acceptNode(). Функция или метод будут вызываться для каждого узла в поддереве, основанном на корне, который принимается во внимание по флагу whatToShow, чтобы определить, следует ли включать его в список итерируемых узлов. Метод должен возвращать одно из значений NodeFilter.FILTER_ACCEPT, NodeFilter.FILTER_REJECT, или NodeFilter.FILTER_SKIP. См. Пример.

Для createNodeIterator, значения NodeFilter.FILTER_REJECT и NodeFilter.FILTER_SKIP эквивалентны. Этот узел не будет включен в список итерируемых узлов, но его дочерние узлы будут продолжать итерироваться.

Новый объект NodeIterator.

const nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  (node) =>
    node.nodeName.toLowerCase() === "p"
      ? NodeFilter.FILTER_ACCEPT
      : NodeFilter.FILTER_REJECT,
);
const pars = [];
let currentNode;

while ((currentNode = nodeIterator.nextNode())) {
  pars.push(currentNode);
}

То же самое, но с использованием объекта с методом acceptNode():

const nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode(node) {
      return node.nodeName.toLowerCase() === "p"
        ? NodeFilter.FILTER_ACCEPT
        : NodeFilter.FILTER_REJECT;
    },
  },
);
const pars = [];
let currentNode;

while ((currentNode = nodeIterator.nextNode())) {
  pars.push(currentNode);
}