NodeIterator: previousNode() 方法

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

浏览器兼容性

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

另请参阅