---
title: DOMTokenList.forEach()
slug: Web/API/DOMTokenList/forEach
tags:
  - API
  - Boucle
  - Chaînes de caractères
  - DOM
  - Itérateurs
  - Méthodes
  - Pour chaque
translation_of: Web/API/DOMTokenList/forEach
---
<p>{{APIRef("DOM")}}</p>

<p>La méthode <strong><code>forEach()</code></strong> de l'interface {{domxref("DOMTokenList")}} appelle le retour donné en paramètre, un pour chaque paire de valeurs dans la liste, dans l'ordre d'insertion.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox"><var>tokenList</var><em>.</em>forEach(<var>callback</var>);
<em>tokenList.</em>forEach<em>(callback, argument);</em>
</pre>

<h3 id="Paramètres">Paramètres</h3>

<dl>
 <dt><code>callback</code></dt>
 <dd>Fonction à exécuter pour chaque élément, prenant éventuellement 3 arguments :
 <dl>
  <dt><em><code>currentValue</code></em></dt>
  <dd>L'élément en cours de traitement dans le tableau.</dd>
  <dt><code><em>currentIndex</em></code></dt>
  <dd>L'index de l'élément en cours de traitement dans le tableau.</dd>
  <dt><em><code>listObj</code></em></dt>
  <dd>Le tableau que <code>forEach()</code> est en train d'appliquer.</dd>
 </dl>
 </dd>
 <dt><em><code>argument</code></em><code> {{Optional_inline}}</code></dt>
 <dd>Valeur à utiliser comme {{jsxref("this")}} lors de l'exécution du <code>callback</code> (<em>rappel</em>).</dd>
</dl>

<h3 id="Valeur_renvoyée">Valeur renvoyée</h3>

<p>{{jsxref('undefined')}} (<em>indéfinie</em>).</p>

<h2 id="Exemple">Exemple</h2>

<p>Dans l'exemple suivant, nous récupérons la liste des classes définies dans un élément {{htmlelement("span")}} en tant que <code>DOMTokenList</code> en utilisant {{domxref("Element.classList")}}. Nous récupérons un itérateur contenant les valeurs avec <code>forEach()</code> et écrivons chacune d'elles dans le  {{domxref("Node.textContent")}} du <code>&lt;span&gt;</code> pendant l'exécution de la fonction interne <code>forEach()</code>.</p>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;span class="a b c"&gt;&lt;/span&gt;</pre>

<h3 id="JavaScript">JavaScript</h3>

<pre class="brush: 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"
);</pre>

<h3 id="Résultat">Résultat</h3>

<p>{{ EmbedLiveSample('Example', '100%', 60) }}</p>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaire</th>
  </tr>
  <tr>
   <td>{{SpecName('DOM WHATWG','#interface-domtokenlist','forEach() (as iterable&lt;Node&gt;)')}}</td>
   <td>{{Spec2('DOM WHATWG')}}</td>
   <td>Définition initiale.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<div>{{Compat("api.DOMTokenList.forEach")}}</div>

<div id="compat-desktop"> </div>

<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>{{domxref("DOMSettableTokenList")}} (objet qui étend DOMTokenList avec la propriété définissable <em>.value</em>)</li>
</ul>