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

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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
forEachChrome Support complet 45Edge Support complet 16Firefox Support complet 50IE Aucun support NonOpera Support complet 32Safari Support complet 10WebView Android Support complet 45Chrome Android Support complet 45Firefox Android Support complet 50Opera Android Support complet 32Safari iOS Support complet 10Samsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
 

Voir aussi