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 的浏览器中加载。
参见
- 它所属的接口:
NodeIterator
。