NodeIterator.detach()

Obsolete
This feature is obsolete. Although it may still work in some browsers, its use is discouraged since it could be removed at any time. Try to avoid using it.

The NodeIterator.detach() method is a no-op, kept for backward compatibility only.

Originally, it detached the NodeIterator from the set over which it iterates, releasing any resources used by the set and setting the iterator's state to INVALID. Once this method had been called, calls to other methods on NodeIterator would raise the INVALID_STATE_ERR exception. 

Syntax

nodeIterator.detach();

Example

var nodeIterator = document.createNodeIterator(
    document.body,
    NodeFilter.SHOW_ELEMENT,
    { acceptNode: function(node) { return NodeFilter.FILTER_ACCEPT; } },
    false
);
nodeIterator.detach(); // detaches the iterator

nodeIterator.nextNode(); // throws an INVALID_STATE_ERR exception

Specifications

Specification Status Comment
DOM
The definition of 'NodeIterator.detach' in that specification.
Living Standard Transformed in a no-op
Document Object Model (DOM) Level 2 Traversal and Range Specification
The definition of 'NodeIterator.detach' in that specification.
Obsolete Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support1123.5 — 22993
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support Yes Yes Yes4 — 2293 Yes

See also

Document Tags and Contributors

Last updated by: ExE-Boss,