1. Web
  2. Les API Web
  3. NodeIterator
  4. NodeIterator.detach()

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

View in English Always switch to English

NodeIterator.detach()

Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut 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

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

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le par les contributeur·ice·s du MDN.

AltStyle によって変換されたページ (->オリジナル) /