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

L'interface à laquelle elle appartient : NodeIterator.