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 July 2015.
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 ducallback
(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
No specification found
No specification data found for api.DOMTokenList.forEach
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Compatibilité des navigateurs
BCD tables only load in the browser
Voir aussi
DOMSettableTokenList
(objet qui étend DOMTokenList avec la propriété définissable .value)