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

Specification
DOM
# dom-nodeiterator-detach

Compatibilité des navigateurs

Voir aussi