Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

NodeIterator.detach()

Obsolète

Cette fonctionnalité est obsolète. Bien qu'encore supportée par des navigateurs, son utilisation est découragée pour tout nouveau projet. Évitez de l'utiliser.

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

nodeIterator.detach();

Exemple

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 Statut Commentaire
DOM
La définition de 'NodeIterator.detach' dans cette spécification.		 Standard évolutif Transformation en non opération
Document Object Model (DOM) Level 2 Traversal and Range Specification
La définition de 'NodeIterator.detach' dans cette spécification.		 Obsolete Définition initiale.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi