ObsoleteThis 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 |
DOMThe definition of 'NodeIterator.detach' in that specification. | Living Standard | Transformed in a no-op |
Document Object Model (DOM) Level 2 Traversal and Range SpecificationThe definition of 'NodeIterator.detach' in that specification. | Obsolete | Initial definition. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox
No support 3.5 — 22 |
IE
Full support 9 |
Opera
Full support 9 |
Safari
Full support 3 |
WebView Android
Full support Yes |
Chrome Android
Full support Yes |
Firefox Android
No support 4 — 22 |
Opera Android
Full support 10.1 |
Safari iOS
Full support 3 |
Samsung Internet Android
Full support Yes |
Legend
- Full support
- Full support
- No support
- No support
- Non-standard. Expect poor cross-browser support.'
- Non-standard. Expect poor cross-browser support.
- Deprecated. Not for use in new websites.'
- Deprecated. Not for use in new websites.
See also
- The interface it belongs to:
NodeIterator
.
NodeIterator.detach() by Mozilla Contributors is licensed under CC-BY-SA 2.5.