Baseline Widely available
La méthode forEach()
permet d'exécuter une fonction donnée sur chaque élément du tableau. Cette méthode implémente le même algorithme que Array.prototype.forEach()
.
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 par forEach()
.
thisArg
Optionnel. La valeur utilisée pour this
lors de l'appel à callback()
.
La méthode forEach()
exécute la fonction callback()
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 valeur undefined
.
callback()
accepte trois arguments :
Si le paramètre thisArg
est fourni à forEach()
, il sera la valeur du this
utilisé par chaque exécution de callback()
. Dans le cas contraire, la valeur undefined
sera utilisée par défaut. Pour déterminer la valeur de this
véritablement visible par callback()
durant son exécution, les règles habituelles pour déterminer la valeur de this du point de vue d'une fonction
sont appliquées.
L'ensemble des éléments visités par forEach()
est fixé avant le premier appel à callback
. Ainsi, les éléments qui sont ajoutés au tableau typé après que l'exécution de forEach()
soit lancée ne seront pas traités. Cependant, si la valeur d'un élément à traiter est modifiée pendant l'exécution de forEach()
, 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 fonction callback()
pour chaque élément du tableau typé ; à la différence de every()
et some()
cette méthode renvoie toujours undefined
.
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
Spécifications Compatibilité des navigateurs Voir aussi
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4