Guide to the JavaScript Reduce Method

JavaScript reduce method is a higher order function that reduces arrays to a single function. Here’s what to know.

Written by Akshay Kumar
Published on Jul. 17, 2023
Engineer coding in javascript
Image: Shutterstock / Built In
Brand Studio Logo

JavaScript reduce() method makes dealing with arrays easier. It’s a higher-order function in JavaScript that takes an array and reduces it to a single value. It’s most often used for data manipulation, which was introduced in ES6.

What Is Javascript Reduce? 

JavaScript reduce() is a higher order function used in data manipulation that reduces an array to a single value. It takes two parameters: an accumulator and the current element of an array. Its uses include calculating the sum or product of all elements, finding the maximum and minimum value, flattening an array, and more.

It takes two parameters: an accumulator and the current element of an array. The accumulator is initialized to the first element of an array. The callback function performs some operation on the accumulator and the current element, and returns the result, which becomes the new value of the accumulator for the next iteration. This will be more clear once we run through some code examples. Let's first discuss how the reduce() method works.

 

JavaScript Reduce Syntax

The syntax for the 'reduce()' method in javascript is as follow:

array.reduce(callback, initialValue); 

Here, 'array' is the array on which the reduce() method is called. The reduce method returns the final value of 'accumulator' after iterating over all the elements in the array.

The 'callback' is a required function that will be called on for each element of the array. The callback function takes four arguments:

  • Accumulator: This contains the value calculated from the previous iteration. On the first iteration, if an initialValue will be provided, the accumulator will be set to the value of initialValue.
  • CurrentValue: The current value of the element is processed in the array.
  • CurrentIndex: The index of the current element is processed in the array.
  • Array: The original array on which the reduce() method was called.

More on JavaScriptHow to Check Data Types in JavaScript Using Typeof

 

How to Use JavaScript Reduce

In Javascript,reduce() method runs a "reducer" callback function over all elements in the array in ascending-index order, and it accumulates them into a single value. Here’s how to use it:

 

1. Define the Function

Define the function you want to apply to each element of an array. This function should take two arguments: the accumulated result and the next element in the array.

For example, let’s find the sum of all elements in an array. We will create the function add and pass two parameters, i.e., accumulator and current value. The function will return the sum of two values. Here is the code snippet.

JavaScript reduce define function code
Code snippet to define the function in JavaScript reduce(). | Image: Akshay Kumar

 

2. Call Reduce()

Then we’ll call the reduce() method on the array you want to apply it to, passing in your function as the first argument.

Code to call reduce() in javascript
Calling the reduce() method on the first array. | Image: Akshay Kumar

 

3. Pass an Initial Value

We can also pass an initial value as the second argument to reduce(). This will be used as the starting value for the accumulated result. Here is the code snippet:

code to pass an initial value in javascript reduce
Code to pass an initial value in Javascript reduce. | Image: Akshay Kumar

The reduce() method works by repeatedly applying the function to the cumulative result and the next element of the iterable, and updating the cumulative result with the return value of the function. This process continues until all the elements of the iterable have been processed and the final result is returned. The reduce() method is a central concept in functional programming, where it’s not possible to mutate any value. In order to accumulate all values in an array, one must return a new accumulator value on every iteration.

reduce() does not mutate the array on which it is called, but the function provided as callbackFn can. The reduce() method can be used to perform a wide range of operations of an array, such as calculating the sum or product of all elements, finding the maximum and minimum value, flattening an array and more.

 

4. Return Value

The value that results from running the "reducer" callback function to completion over the entire array.

 

JavaScript Reduce Examples

Below are some common ways you can use JavaScript reduce(), including: 

  • Find an average of an array. 
  • Flatten an array.
  • Remove duplicate items in an array.

 

1. Finding an Average of an Array With JavaScript Reduce

To find the average of an array using reduce() method in JavaScript, we can first calculate the sum of all elements in the array using reduce() and then divide the sum by the length of the array.

Here is an example to calculate the average using reduce().

Code to find an average of an array in javascript. | Image: Akshay Kumar
Code to find the average of an array using JavaScript reduce(). | Image: Akshay Kumar

In the above example, we have an array (arrayNum) of integers. Using reduce() method, we are calculating the sum of all the numbers in the array. Zero is the initial value of the sum. To calculate the average, divide the total sum by the length of the array. Finally, we print the average to the console using 'console.log()'.

 

2. Flatten Arrays with JavaScript Reduce

To flatten the arrays using 'reduce()' method, we follow the steps:

  • Define the multidimensional array that we want to flatten.
  • Use the 'reduce()' method to iterate over the array and concatenate each element to the new array.
  • Return the flattened array.

Here is an example code snippet:

code to flatten an array in javascript reduce()
Code to flatten an array in JavaScript reduce. | Image: Akshay Kumar

In the above code, we define a multidimensional array (flattenArrayNumbers) that contains three nested arrays. We use 'reduce()' to concatenate each element of the nested arrays to the new array 'flattenArrayNumbers'. The initial value of 'accumulator' is an empty array, which is passed as the second argument to 'reduce()'. Finally, flattened array output is returned.

A tutorial on how to use the JavaScript reduce() method. | Video: Web Dev Simplified

More on JavaScriptHow to Make JavaScript Sleep or Wait

 

Remove Duplicate Items in an Array With JavaScript Reduce

To remove duplicates in the arrays using 'reduce()' method, we’ll follow the following steps:

  • Define the array with duplicate values.
  • Use the reduce() method to iterate over the array and use the includes method to check if the number is already present in the array. Then, we skip the number and add only unique items in the accumulator.
  • Return the accumulator with unique items.

Here is an example code snippet that demonstrates the above steps:

code to remove duplicate items in an array with javascript reduce.
Code to remove duplicate items in an array with javascript reduce. | Image: Akshay Kumar

In the above code, we define an array(myArray) that contains duplicate numbers. We then use 'reduce()' to iterate over the array. Using includes(), we check the number to determine if it is already present in the accumulator and return the array with unique items. The initial value of 'accumulator' is an empty array, which is passed as the second argument to 'reduce()'. Finally, a new array with unique elements is returned.

 

JavaScript Reduce Method Useful Tips and Mistakes

Here are some useful tips to use reduce() method in JavaScript:

  • Always provide an initial value to the accumulator.
  • Make sure the callback function is pure. The callback function should not modify the values of the original array.
  • Understand the parameters of the callback function. The callback function takes two parameters: the accumulator and the current value of the array being processed.
  • Use the accumulator to store the intermediate result. The accumulator is the value that is returned by the callback function and passed as the first argument in the next iteration.
  • Use the array function syntax to write concise code. The arrow function syntax makes it easy to write concise and readable code for the callback function.

Here are some common mistakes to avoid when using the reduce() in Javascript:

  • Modifying the original array or external state inside the callback function.
  • reduce() should be used to return a new value based on the inputs, not to modify the original array or external state.
  • Nesting too many operations inside the callback function.
  • Not understanding the parameters of the callback function.
  • Not providing the initial value to the accumulator.
Explore Job Matches.