Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Array.prototype.reduce : réduction en une valeur

reduce visite les éléments présents et les combine au moyen d’un accumulateur en une seule valeur.

Version : ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.reduce(callbackFn[, initialValue])

array.reduce(callbackFn[, initialValue]) appelle callbackFn(accumulator, currentValue, index, array) pour les indices présents en ordre croissant et renvoie l’accumulateur final. Avec initialValue, il part de cette valeur. Sinon, le premier élément présent devient l’accumulateur et n’est pas transmis comme currentValue.

Les trous sont ignorés. Un tableau vide ou composé seulement de trous sans initialValue lève TypeError ; undefined explicite compte comme valeur initiale fournie. La longueur est capturée avant l’itération : les ajouts au-delà sont ignorés et un indice pas encore visité supprimé à temps est sauté. La méthode elle-même ne modifie rien et est générique pour array-like ; un callback non appelable, un receveur null ou undefined et les erreurs du callback lèvent une exception.

Exemples

const sparse = [, 2, , 4];
const steps = [];
const total = sparse.reduce((accumulator, value, index) => {
  steps.push(index + ":" + accumulator + "+" + value);
  return accumulator + value;
}, 1);
console.log(total);
console.log(steps.join("|"));
console.log([, 5, ,].reduce((a, b) => a + b));
try { [].reduce((a, b) => a + b); } catch (error) { console.log(error.name); }

Résultat

7
1:1+2|3:3+4
5
TypeError

Sources