Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

DOMTokenList.forEach()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨octobre 2017⁩.

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

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

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

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

JavaScript

js
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

This feature does not appear to be defined in any specification.

Compatibilité des navigateurs

Voir aussi