Tutorial

JavaScript reduce: Başlangıç Değeri ve Güvenli Toplama

Mehmet Fatih Ünal
13 Kasım 2026
7 dk okuma
#JavaScript#Array#reduce#Veri Doğrulama#Map
JavaScript reduce: Başlangıç Değeri ve Güvenli Toplama

reduce hangi problemi çözer?

JavaScript reduce, dizideki girdileri bir accumulator üzerinden tek bir sonuca dönüştürür. Sonuç bir sayı olabileceği gibi Map veya başka bir veri yapısı da olabilir. Güvenilir bir kullanımda başlangıç değeri, callback'in döndürdüğü değer ve kabul edilen girdi türü birlikte tasarlanır.

Örneğin bir listedeki adetleri toplamak basittir; aynı liste boş geldiğinde veya API bir adedi metin olarak gönderdiğinde beklenen davranış daha az açıktır. MDN reduce referansı callback ve başlangıç değeri kurallarını açıklıyor.

const values = [4, 7, 2];
const total = values.reduce((sum, value) => sum + value, 0);
console.log(total); // 13

Burada accumulator her adımda sayıdır. Sonraki çağrının ilk argümanı, önceki çağrının return değeridir; değişkenin adı sum olduğu için otomatik olarak toplama yapılmaz.

Başlangıç değeri boş dizide neyi değiştirir?

console.log([].reduce((sum, value) => sum + value, 0)); // 0

try {
  [].reduce((sum, value) => sum + value);
} catch (error) {
  console.log(error instanceof TypeError); // true
}

Başlangıç değeri verilmezse reduce ilk mevcut elemanı accumulator olarak kullanır. Dizide kullanılabilecek eleman yoksa TypeError oluşur. Bu nedenle boş sonucun anlamı sıfırsa bunu ikinci argümanda belirtmek daha açık bir sözleşme kurar.

Tek elemanlı bir dizide başlangıç değeri yokken callback hiç çağrılmayabilir. Doğrulamayı yalnızca callback'e koyup ilk girdinin mutlaka kontrol edildiğini varsaymayın. Aşağıdaki yardımcı bu riski başlangıcı açıkça sıfır vererek önler.

Metin ve geçersiz adetleri toplama sınırında reddedin

function totalUnits(lines) {
  return lines.reduce((sum, line) => {
    const units = line.units;
    if (!Number.isSafeInteger(units) || units < 0) {
      throw new TypeError('units must be a non-negative safe integer');
    }
    const next = sum + units;
    if (!Number.isSafeInteger(next)) {
      throw new RangeError('total exceeds the safe integer range');
    }
    return next;
  }, 0);
}

console.log(totalUnits([{ units: 2 }, { units: 4 }])); // 6
console.log(totalUnits([])); // 0

Bu örnek "2" metnini, NaN değerini, kesirleri ve negatif sayıları kabul etmez. Dönüşüm gerekiyorsa API sınırında ayrı ve açık bir kuralla yapın. Number ile güvenli tam sayı aralığını aşan toplamı da sessizce büyütmek yerine hata olarak ele alır.

Girdilerin nesne olduğu ve units alanını taşıdığı varsayılıyor; bu yardımcı bütün bir şema doğrulayıcısı değildir. Callback'te süslü parantez kullandığınızda return'ü unutmak da accumulator'ı undefined yapar. Varsayılan değerler rehberi, eksik veriyi yanlışlıkla geçerli sayıya dönüştürmemek için ilgili bir tamamlayıcıdır.

Bir Map üzerinde sayaç biriktirin

const states = ['paid', 'pending', 'paid'];
const counts = states.reduce((acc, state) => {
  acc.set(state, (acc.get(state) ?? 0) + 1);
  return acc;
}, new Map());

console.log([...counts]); // [['paid', 2], ['pending', 1]]

Burada değiştirilen Map bu hesaplama için yeni oluşturulmuştur; girdi dizisi değiştirilmez. Her adımda büyüyen accumulator'ın tamamını spread ile kopyalamak gerekli değildir. Tekrar tekrar bütün girdileri kopyalamak toplam işi büyütebilir; küçük bir örnekte kısa görünen kodu büyük listede de ölçün.

Aynı sayaç açık bir for...of döngüsüyle de yazılabilir. Takımın kolay okuyabildiği seçenek daha değerlidir. Map ve Set rehberi, anahtar ve nesne kimliği kurallarını ayrıntılandırıyor.

Boş yuva ile undefined aynı şey mi?

const sparse = [2, , 5];
const explicit = [2, undefined, 5];
console.log(sparse.reduce((sum, value) => sum + value, 0)); // 7
console.log(Number.isNaN(
  explicit.reduce((sum, value) => sum + value, 0)
)); // true

Reduce eksik yuvaları atlar; açıkça bulunan undefined girdisini atlamaz. ECMAScript algoritması bu eleman varlığı kontrolünü tanımlar. Bu ayrım, seyrek bir dizinin doğrulama kapsamını değerlendirirken de önemlidir.

reduce her dönüşüm için doğru seçenek mi?

Her elemanı bağımsız dönüştürmek için map, bazılarını seçmek için filter daha doğrudan olabilir. Aranan şey tek bir eşleşmeyse find veya some ile amacı anlatmak genellikle daha kolaydır. Accumulator'ın biçimi sık değişiyor ya da callback yan etkilerle doluyorsa bir döngüye dönmeyi değerlendirin.

Sık sorulan sorular

reduce diziyi kendisi değiştirir mi? Hayır; fakat callback'iniz girdileri veya dışarıdaki nesneleri değiştirebilir.

Başlangıç olarak undefined vermek, argümanı vermemekle aynı mı? Hayır. Açıkça verilen undefined ilk accumulator olur; argümanın yokluğu ayrı bir durumdur.

Toplam neden metne dönüşür? Artı operatörü bir metinle karşılaşınca birleştirme yapabilir. Girdi türünü toplama başlamadan belirleyin.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar