La méthodereduce() applique une fonction sur un accumulateur et chaque valeur du tableau typé (de la gauche vers la droite) afin de réduire le tableau en une seule valeur. Cette méthode utilise le même algorithme queArray.prototype.reduce(). Dans le reste de cet articleTypedArray correspond à un destypes de tableaux typés.

Exemple interactif

const uint8 = new Uint8Array([0, 1, 2, 3]);function sum(accumulator, currentValue) {  return accumulator + currentValue;}console.log(uint8.reduce(sum));// Expected output: 6

Syntaxe

typedarray.reduce(callback[, valeurInitiale])

Paramètres

callback

La fonction à exécuter sur chaque valeur du tableau typé. Elle utilise quatre arguments :

valeurPrécédente

La valeur renvoyée précédemment par l'appel précédent àcallback. Dans le cadre du premier élément, ce seravaleurInitiale si ce paramètre est fourni (voir ci-après).

valeurCourante

L'élément du tableau typé en cours de traitement

index

L'indice de l'élément du tableau typé en cours de traitement.

array

Le tableau typé pour lequelreduce a été appelée.

valeurInitiale

Paramètre optionnel qui correspond à l'objet à utiliser en tant que premier argument pour le premier appel àcallback.

Valeur de retour

La valeur obtenue à partir de la réduction du tableau typé.

Description

reduce exécute la fonctioncallback une fois pour chaque élément présent dans le tableau typé (les éléments vides ou supprimés ne sont pas traités). La fonctioncallback utilise quatre arguments : la valeur initiale ou la valeur précédemment calculée, la valeur de l'élément courant, l'indice de l'élément courant et le tableau typé qui est parcouru.

Lors du premier appel à la fonction callback,valeurPrécédente etvaleurCourante peuvent être un ou deux valeurs différentes. SivaleurInitiale est fournie,valeurPrécédente sera alors égale àvaleurInitiale etvaleurCourante sera égale à la première valeur du tableau. Si le paramètrevaleurInitiale n'est pas utilisé,valeurPrécédente sera égale au premier élément du tableau typé etvaleurCourante sera égale au second élément.

Si le tableau typé est vide et que le paramètrevaleurInitiale n'a pas été fourni, une exceptionTypeError sera levée. SI le tableau typé ne possède qu'un seul élément et quevaleurInitiale n'a pas été fourni (ou quevaleurInitiale a été utilisée mais que le tableau typé est vide), la valeur unique sera renvoyée etcallback ne sera pas appelée.

Exemples

var total = new Uint8Array([0, 1, 2, 3]).reduce(function (a, b) {  return a + b;});// total == 6

Spécifications

Compatibilité des navigateurs

Voir aussi

• TypedArray.prototype.reduceRight()
• Array.prototype.reduce()