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

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Oui) Pas de support 50 (50) ? (Oui) ?
Fonctionnalité Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support Pas de support (Oui) 50.0 (50) ? (Oui) ? (Oui)

Voir aussi

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : loella16
 Dernière mise à jour par : loella16,