blob: f6fa126d80e569cb334821ef4f3e2f1a3d81ccde (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
|
---
title: NodeIterator.detach()
slug: Web/API/NodeIterator/detach
tags:
- API
- Arborescence
- DOM
- Itérateur
- Méthodes
- Noeuds
translation_of: Web/API/NodeIterator/detach
---
{{APIRef("DOM")}}{{obsolete_header}}
La méthode **`NodeIterator.detach()`** est une non opération, conservée seulement pour la rétro-compatibilité.
Initialement, elle détachait {{domxref("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 |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ------------------------------- |
| {{SpecName('DOM WHATWG', '#dom-nodeiterator-detach', 'NodeIterator.detach')}} | {{Spec2('DOM WHATWG')}} | Transformation en non opération |
| {{SpecName('DOM2 Traversal_Range', 'traversal.html#Traversal-NodeIterator-detach', 'NodeIterator.detach')}} | {{Spec2('DOM2 Traversal_Range')}} | Définition initiale. |
## Compatibilité des navigateurs
{{Compat("api.NodeIterator.detach")}}
## Voir aussi
- L'interface à laquelle elle appartient : {{domxref("NodeIterator")}}.
|
