The mighty reduce

Back in December 2009, ES5 (formally: ECMA-262 5th Edition) included several new functions and methods. The most important ones, from a functional programming (FP) point of view, were the trio (quartet?) formed by:

• .map(…) that transforms one array into another by applying a given function to each of its elements, in order
• .filter(…) that picks the array elements that satisfy a given condition
• and two versions of a powerful method that we’ll study here: .reduce(…) and .reduceRight(…). These functions apply an operation to a whole array (from left to right or from right to left) reducing it to a single result.

All these are “higher-order functions” (HOF) as we already saw in our Higher Order Functions — Functions to rule functions article. As we defined there, a HOF is a function that takes one or more functions as arguments. All the methods we listed above satisfy this, and using them allows you to code in a more declarative way. For instance, to select some elements from an array, you don’t have to write out a loop, initialize a new output array, etc.: you write yourArray.filter(someFunction) and a new array will be produced with all the values from the original array that produce true when someFunction(...) is applied to them. Instead of specifying how to produce the result, step by step, you declare what elements interest you, and this FP-oriented method does the work for you.

What’s interesting is that most of these methods are actually redundant. In fact, you can make do with just one: .reduce(...)! In this article, we’ll study how to use it to emulate its siblings. That will give us an insight into their internal workings, and we’ll also see techniques we may want to use elsewhere. Let’s first get a reminder of how .reduce(...) works, and then get to use it as an alternative to the other methods.

Reducing an array to a value

The normal (recommended) way to use .reduce(...) is like yourArray.reduce(someFunction, initialValue). You can skip providing an initial value, but that may lead to errors down the line, so better don’t. How does reducing work? The process is as follows:

• initialize an accumulator with initialValue
• set accumulator = someFunction(accumulator, yourArray[0])
• then set accumulator = someFunction(accumulator, yourArray[1])
• and then accumulator = someFunction(accumulator, yourArray[2])
• …going through all the array in order, doing the same, until its last element.

A very well-known example: if you had an array with numbers, you could add them up in a single line by writing yourArray.reduce((x,y)=>x+y, 0). The accumulator would start at zero (logical, for a sum). Then, each successive element of the array would be added to it. The final result would be the sum of all the elements of the array. Working in this way avoids all possibility of “off-by-one” errors, handles initialization and handling of results, and is side-effect free. (We discussed side-effect-free, pure functions in our Injecting for Purity article.)

In usual FP-speak, .reduce(...) is known as “fold” or possibly “foldl” (“fold left”) and .reduceRight(...) is “foldr” (“fold right”).

Now, it may not be that obvious that .reduce(...) is good enough to mimic all the other methods. So, let’s start with the simplest case, reducing from right to left.

Reducing from the right

The sibling of .reduce(...), .reduceRight(...) works exactly the same way, but instead of going through the array from the beginning to its end, it starts at the end and goes back to its beginning. For many things (like summing an array as we did above) this makes no difference but, in other cases, it might. How can we emulate this method? It will be easy!

The only difference, as we said, is that the array is processed in right-to-left order… so the simplest solution is (first) to reverse the array, and (second) reduce it to a value! We could almost write an “equation”: yourArray.reduceRight(someFunction, initialValue) === yourArray.reverse().reduce(someFunction, initialValue)… but this has a problem; can you see it?

What’s happening here? The key is that .reverse(...) is a mutator method — it actually reverses the array in place. So, working in this way we’ll get the same final result… But we’ll have also have produced an unexpected side effect: the array will be reversed! The right way to do things is by generating a copy of the array first. We should write

yourArray.reduceRight(someFunction, initialValue) === 
[...yourArray].reverse().reduce(someFunction, initialValue)

OK, why would we want to use this version? Short answer: we wouldn’t! The conclusion we wanted is that .reduce(...) is capable by itself of emulating the alternative .reduceRight(...)… though, in this case, the solution doesn’t seem to be worth the problem! As we said, this will be more of a sort of exercise in lateral thinking, finding new ways of doing things, and it’s more about the way rather than the destination. Let’s now see about the other methods.

Mapping an array

Going through a list of elements and performing some kind of transformation on them is a very common pattern in algorithms. When you start to learn how to program, writing such loops is a basic task. We can certainly process an array in that fashion, with a for(...) statement, but .map(...) lets us work functionally, in a more declarative way. A common example: with an array of persons with firstName and lastName attributes we could produce all full names with the following.

let fullNames = persons.map((p) => p.firstName + " " + p.lastName);

When you write yourArray.map(aFunction) the result is that aFunction(...) (your “mapping function”) is applied to every element of the array, thus producing a new array.

In math, a “map” is a transformation of values from a set into another one, like strings to numbers, objects to booleans, etc. In JavaScript, .map(…) transforms an array into a new one.

Can we simulate this process with .reduce(...)? The answer is “yes”, and the solution is short. Given that we want to produce a new array, let’s have an empty array as the initial value for reducing, and then add the mapped results to it, one at a time.

const mapByReduce = (yourArray, aFunction) => yourArray.reduce((a, v) => a.concat(aFunction(v)), []);

Let’s go through the code. We start with an empty array. Each element v of the array is given as the argument to the function, and the result is concatenated to the array a. When finished, the produced array will have the same result that applying .map(...) would have had — once again, .reduce(...) proves its power! We wrote mapByReduce(...) as a function, but we could have added it to the Array.prototype if we wanted — but why do this? We’re studying the new implementation to add to our understanding of several methods, and not to (needlessly, I should say) replace them. Let’s now consider the last method, filtering.

Open Source Session Replay

OpenReplay is an open-source, session replay suite that lets you see what users do on your web app, helping you troubleshoot issues faster. OpenReplay is self-hosted for full control over your data.

Start enjoying your debugging experience - start using OpenReplay for free.

Filtering an array

Filtering an array is somewhat similar to mapping in that a function is applied to each element of an array, but in this case it’s used differently: if the function produces a ”truthy” value, the corresponding element is selected and added to the result; if ”falsy”, the element is excluded. For example, with the same array of persons as in the previous example, if each had an age attribute, we could easily pick the adults.

let adults = persons.filter((p) => p.age >= 21);

How can we emulate this? The solution is similar to that of mapping. We will start with an empty array, and after applying the filtering function to each element, we’ll add it to the result if and only if the function produced a truthy value.

const filterByReduce = (yourArray, aFunction) => yourArray.reduce((a, v) => (aFunction(v) ? a.concat(v) : a), []);

We use the ternary operator to decide, depending on the result of the function, whether to add or not the original element of the array to the final result. Once again, we’ve seen that .reduce(...) is powerful enough so you could use it as your only tool — not that you’d want to, obviously, since the other methods already exist!

Summary

In this article, we’ve considered several basic FP methods, and we’ve seen that one of them, reducing, is powerful enough to emulate all others. This is, however, just an exercise — why reinvent the wheel? The detail is that we’ve applied some interesting techniques, and learned more about how to use reducing in original ways, which you certainly may apply to your own code.