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 的浏览器中加载。

另请参见