NodeIterator: detach() 方法
已弃用: 此功能不再推荐。虽然一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能只是为了兼容性而保留。避免使用它,并尽可能更新现有代码;请参阅此页面底部的 兼容性表 来指导您的决策。请注意,此功能可能随时停止工作。
NodeIterator.detach()
方法是一个空操作,仅保留用于向后兼容。
最初,它将 NodeIterator
从其迭代的集合中分离,释放集合使用的任何资源,并将迭代器的状态设置为 INVALID
。一旦此方法被调用,对 NodeIterator
上其他方法的调用将引发 INVALID_STATE_ERR
异常。
语法
js
detach()
参数
无。
返回值
无 (undefined
).
示例
js
const nodeIterator = document.createNodeIterator(
document.body,
NodeFilter.SHOW_ELEMENT,
{
acceptNode(node) {
return NodeFilter.FILTER_ACCEPT;
},
},
);
nodeIterator.detach(); // detaches the iterator
nodeIterator.nextNode(); // throws an INVALID_STATE_ERR exception
规范
规范 |
---|
DOM 标准 # dom-nodeiterator-detach |
浏览器兼容性
BCD 表仅在启用 JavaScript 的浏览器中加载。
另请参见
- 它所属的接口:
NodeIterator
.