NodeIterator.detach()
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
La méthode NodeIterator.detach() est une non opération, conservée seulement pour la rétro-compatibilité.
Initialement, elle détachait NodeIterator de l'ensemble sur lequel il itérait, libérant toutes les ressources utilisées par lui et basculant son état à INVALID. Une fois cette méthode utilisée, l'appel d'autres méthodes sur le NodeIterator déclenchait une exception INVALID_STATE_ERR.
Syntaxe
js
nodeIterator.detach();
Exemple
js
var nodeIterator = document.createNodeIterator(
document.body,
NodeFilter.SHOW_ELEMENT,
{
acceptNode: function (node) {
return NodeFilter.FILTER_ACCEPT;
},
},
false,
);
nodeIterator.detach(); // détache l'itérateur
nodeIterator.nextNode(); // lance une exception INVALID_STATE_ERR
Spécifications
| Spécification |
|---|
| DOM # dom-nodeiterator-detach |
Compatibilité des navigateurs
Voir aussi
- L'interface à laquelle elle appartient :
NodeIterator.