Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Reduções e estatísticas de arrays

Uma redução combina elementos de um array num único resultado. Saiba como o acumulador de Array.prototype.reduce() permite calcular contagens, somas, mínimos, máximos e médias, incluindo o tratamento explícito de arrays vazios e esparsos.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

array.reduce((accumulator, currentValue, currentIndex, array) => nextAccumulator, initialValue)

Uma redução transforma uma sequência de valores num único resultado, como uma soma ou um objeto de estatísticas. Array.prototype.reduce() percorre os elementos existentes por ordem crescente de índice. A função de callback recebe o acumulador, o valor atual, o índice e o array; o valor devolvido passa a ser o acumulador seguinte. Devolva-o em todas as chamadas.

Indique initialValue para definir explicitamente o estado inicial. Sem esse valor, o primeiro elemento existente torna-se o acumulador e o processamento começa no seguinte. Um array vazio sem initialValue lança um TypeError; com esse valor, devolve o valor inicial. Os espaços vazios sem uma propriedade indexada herdada são ignorados, pelo que array.length não corresponde necessariamente ao número de valores processados.

O exemplo calcula count, sum, min e max numa só passagem e, em seguida, calcula a média como sum / count. Infinity e -Infinity inicializam os extremos. Para uma entrada vazia, o resultado usa null para o mínimo, o máximo e a média — uma convenção explícita deste exemplo. A função de callback modifica apenas o novo objeto acumulador; reduce() não modifica o próprio array.

O exemplo pressupõe valores Number finitos. Defina regras de validação para dados externos: + pode concatenar cadeias de caracteres e NaN prejudica os cálculos. A aritmética Number pode introduzir erros de arredondamento. A redução e a serialização com JSON.stringify() utilizam funcionalidades do ECMAScript. Já a apresentação do resultado requer console.log(), um método que faz parte de uma API Web nos navegadores e que, em Node.js, é disponibilizado pelo ambiente de execução. Verifique se console.log() está disponível no seu ambiente de execução.

Exemplos

const values = [4, 8, 6, 2];
const stats = values.reduce((acc, value) => {
  acc.count += 1;
  acc.sum += value;
  acc.min = Math.min(acc.min, value);
  acc.max = Math.max(acc.max, value);
  return acc;
}, { count: 0, sum: 0, min: Infinity, max: -Infinity });

const mean = stats.count === 0 ? null : stats.sum / stats.count;
const min = stats.count === 0 ? null : stats.min;
const max = stats.count === 0 ? null : stats.max;
console.log(JSON.stringify({ ...stats, min, max, mean }));

Resultado

{"count":4,"sum":20,"min":2,"max":8,"mean":5}

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes