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
JavaScript
Copy Code
nodeIterator.detach();
Example
JavaScript
Copy Code
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. |
Recommendation | Initial definition. |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 1.0 | 3.5 (1.9.1) Since 22 (22), acts as a no-op. |
9.0 | 9.0 | 3.0 |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes) | 1.0 (1.9.1) Since 22 (22), acts as a no-op. |
(Yes) | 9.0 | 3.0 |
See also
- The interface it belongs to:
NodeIterator
.
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/nodeiterator/detach