DOMTokenList.forEach()

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 du callback (rappel).

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)