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é a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

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