NodeIterator: previousNode() 方法

Baseline 已廣泛支援

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

NodeIterator.previousNode() 方法返回 NodeIterator 所表示的集合中的上一個節點,並將迭代器的位置向後移動。

噹噹前節點是集合中的第一個節點時,此方法返回 null

在舊版本的瀏覽器中,根據舊版本的規範,如果在呼叫 NodeIterator.detach() 方法後呼叫此方法,則可能會丟擲 INVALID_STATE_ERR DOMException。較新的瀏覽器永遠不會丟擲此異常。

語法

js
previousNode()

引數

無。

返回值

一個 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
previousNode = nodeIterator.previousNode(); // same result, since we backtracked to the previous node

規範

規範
DOM
# dom-nodeiterator-previousnode

瀏覽器相容性

另見