TypedArray.prototype.forEach()

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨septembre 2016⁩.

La méthodeforEach() permet d'exécuter une fonction donnée sur chaque élément du tableau. Cette méthode implémente le même algorithme queArray.prototype.forEach().

Syntaxe

tableauTypé.forEach(callback[, thisArg])

Paramètres

callback

La fonction à utiliser pour chaque élément du tableau typé. Elle prend trois arguments :

valeurÉlément: La valeur de l'élément traité actuellement.
indiceÉlément: L'indice de l'élément traité actuellement.
tableau: Le tableau parcouru parforEach().

thisArg

Optionnel. La valeur utilisée pourthis lors de l'appel àcallback().

La méthodeforEach() exécute la fonctioncallback() une fois pour chaque élément présent dans le tableau typé, par ordre d'indice croissant. Cette fonction n'est pas appelée pour les indices sur lesquels les éléments ont été supprimés ou n'ont pas été définis.callback() est cependant appelée pour les éléments qui portent la valeurundefined.

callback() acceptetrois arguments :

lavaleur de l'élément
l'indice de l'élément
lele tableau typé traversé

Si le paramètrethisArg est fourni àforEach(), il sera la valeur duthis utilisé par chaque exécution decallback(). Dans le cas contraire, la valeurundefined sera utilisée par défaut. Pour déterminer la valeur dethis véritablement visible parcallback() durant son exécution, les règles habituelles pourdéterminer la valeur de this du point de vue d'une fonction sont appliquées.

L'ensemble des éléments visités parforEach() est fixé avant le premier appel àcallback. Ainsi, les éléments qui sont ajoutés au tableau typé après que l'exécution deforEach() soit lancée ne seront pas traités. Cependant, si la valeur d'un élément à traiter est modifiée pendant l'exécution deforEach(), la valeur passée àcallback() sera celle de l'élément au moment où il est traité. Si un élément est supprimé avant d'être visité, il ne sera pas traité.

forEach() lance un appel à la fonctioncallback() pour chaque élément du tableau typé ; à la différence deevery() etsome() cette méthode renvoie toujoursundefined.

Exemples

Exemple: Affichage du contenu d'un tableau typé

Le code ci-dessous affiche une ligne pour chaque élément du tableau typé :

function affichageContenuTableau(élément, index, tableau) {  console.log("a[" + index + "] = " + élément);}new Uint8Array([0, 1, 2, 3]).forEach(affichageContenuTableau);// log :// a[0] = 0// a[1] = 1// a[2] = 2// a[3] = 3