NodeIterator: nextNode() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

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

瀏覽器相容性

另見