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.

tokenList.forEach(callback);
tokenList.forEach(callback, argument);

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).

undefined (indéfinie).

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().

<span class="a b c"></span>

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"
);

• DOMSettableTokenList (objet qui étend DOMTokenList avec la propriété définissable .value)