NodeIterator:nextNode() 方法

NodeIterator.nextNode() 方法返回由 NodeIterator 表示的集合中的下一个节点,并推进迭代器在集合中的位置。第一次调用 nextNode() 返回集合中的第一个节点。

当集合中没有剩余节点时,此方法返回 null

在旧版浏览器中,根据规范的旧版本,如果在 NodeIterator.detach() 方法之后调用此方法,则该方法可能会抛出 INVALID_STATE_ERR DOMException。最近的浏览器从未抛出异常。

语法

js
nextNode()

参数

无。

返回值

一个 Node,表示此 NodeIterator 所表示的集合中当前节点之后的节点,如果当前节点是集合中的最后一个节点,则返回 null

示例

js
const nodeIterator = document.createNodeIterator(
  document.body,
  NodeFilter.SHOW_ELEMENT,
  {
    acceptNode(node) {
      return NodeFilter.FILTER_ACCEPT;
    },
  },
);
currentNode = nodeIterator.nextNode(); // returns the next node

规范

规范
DOM 标准
# dom-nodeiterator-nextnode

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

参见