TypedArray.prototype.forEach()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2016.

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().

Syntaxe

js
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().

Valeur de retour

Description

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 :

  • la valeur de l'élément
  • l'indice de l'élément
  • le le tableau typé traversé

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.

Exemples

Exemple: Affichage du contenu d'un tableau typé

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

js
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

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.foreach

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi