La méthode forEach()
de l'interface DOMTokenList
appelle le retour donné en paramètre, un pour chaque paire de valeurs dans la liste, dans l'ordre d'insertion.
Syntaxe
tokenList.forEach(callback); tokenList.forEach(callback, argument);
Paramètres
callback
- Fonction à exécuter pour chaque élément, prenant éventuellement 3 arguments :
currentValue
- L'élément en cours de traitement dans le tableau.
currentIndex
- L'index de l'élément en cours de traitement dans le tableau.
listObj
- Le tableau que
forEach()
est en train d'appliquer.
argument
Facultatif
- Valeur à utiliser comme
this
lors de l'exécution ducallback
(rappel).
Valeur renvoyée
undefined
(indéfinie).
Exemple
Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément <span>
en tant que DOMTokenList
en utilisant Element.classList
. Nous récupérons un itérateur contenant les valeurs avec forEach()
et écrivons chacune d'elles dans le Node.textContent
du <span>
pendant l'exécution de la fonction interne forEach()
.
HTML
<span class="a b c"></span>
JavaScript
var span = document.querySelector("span"); var classes = span.classList; var iterator = classes.values(); classes.forEach( function(value, key, listObj) { span.textContent += value + ' ' + key + "/" + this + ' ++ '; }, "arg" );
Résultat
Spécifications
Spécification | Statut | Commentaire |
---|---|---|
DOM La définition de 'forEach() (as iterable<Node>)' dans cette spécification. |
Standard évolutif | Définition initiale. |
Compatibilité des navigateurs
Fonctionnalité | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Support simple | Oui | Non | 50 | ? | Oui | ? |
Fonctionnalité | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
---|---|---|---|---|---|---|---|
Support simple | Oui | Oui | ? | 50 | Oui | ? | Oui |
Voir aussi
DOMSettableTokenList
(objet qui étend DOMTokenList avec la propriété définissable .value)