La méthode reduceRight() applique une fonction sur un accumulateur et chaque valeur du tableau typé (de la droite vers la gauche) afin de réduire le tableau en une seule valeur. Cette méthode utilise le même algorithme que Array.prototype.reduceRight(). Dans le reste de cet article TypedArray correspond à un des types de tableaux typés.

Syntaxe

typedarray.reduceRight(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 sera valeurInitiale 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 lequel reduceRight 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

La méthode reduceRight exécute la fonction callback 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 fonction callback 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.

L'appel à reduceRight utilisant la fonction callback ressemble à :

typedarray.reduceRight(function(valeurPrécédente, valeurCourante, index, typedarray) {
  // ...
});

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

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

Exemples

Additionner les éléments d'un tableau

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

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de '%TypedArray%.prototype.reduceRight' dans cette spécification.
Standard Définition initiale.
ECMAScript Latest Draft (ECMA-262)
La définition de '%TypedArray%.prototype.reduceRight' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung InternetNode.js
Support simpleChrome Support complet 45Edge Support complet 14Firefox Support complet 37IE Aucun support NonOpera Support complet 32Safari Support complet 10WebView Android ? Chrome Android ? Edge Mobile Support complet OuiFirefox Android Support complet 37Opera Android Aucun support NonSafari iOS Support complet 10Samsung Internet Android ? nodejs Support complet 4.0.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,