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
BCD tables only load in the browser
Voir aussi
DOMSettableTokenList
(objet qui étend DOMTokenList avec la propriété définissable .value)