Flattening arrays in JavaScript

by Janeth Kent Date: 10-05-2021 javascript

When we are handling arrays that are arrays or have multiple dimensions it can be very useful to know how to flatten arrays in JavaScript. That is to say, to move all the elements to a single dimension. This simplifies things like traversing the elements or being able to dump them into some system.

Until version ES10 (or ES2019) it was a procedure that we had to do by hand, but since this version of the JavaScript standard we already have a method of the Array object that is .flat() and that helps us to flatten arrays in JavaScript.

The first thing to do is to create our multi-dimensional array, which could look something like this:

const a=[[1,2],[3,[4,5],6],[7],[8,9,10]];

As we can see we have several depths of nested arrays. In the case of having to flatten it by hand we will have to take this depth into account.

The next thing to do is to call the .flat() method:

const a_flat = a.flat();

Note that if we do not pass any information to the .flat() method it will only flatten the first level. That's why if we traverse the array with JavaScript:

for (x=0;x<a_flat.length;x++)    

The console output will be as follows:


Where we can see that it has not flattened the fourth element, which returns to being an array.

That is why the .flat() method must be given the depth level on which we want to flatten. In this case we are going to pass a level 2:

const a_flat = a.flat(2);

The console output will be as follows:


Although the .flat() method is already implemented in most major browsers it can be a problem if you have to maintain some browser compatibility.

In this case it is important that you take a look at the compatibility of the .flat() method in Can I Use.


Data on support for the array-flat feature across the major browsers from caniuse.com


If not, you can always implement a pollyfill like the one below:

function flattenDeep(a) {     
   return a.reduce((acc, val) => Array.isArray(val) ? 
   acc.concat(flattenDeep(val)) : acc.concat(val), []);  

I hope you find it useful to use the .flat() method to flatten arrays in JavaScript. In which cases do you think it would be useful?

by Janeth Kent Date: 10-05-2021 javascript hits : 2373  
Janeth Kent

Janeth Kent

Licenciada en Bellas Artes y programadora por pasión. Cuando tengo un rato retoco fotos, edito vídeos y diseño cosas. El resto del tiempo escribo en MA-NO WEB DESIGN AND DEVELOPMENT.


Related Posts

How to use the endsWith method in JavaScript

In this short tutorial, we are going to see what the endsWith method, introduced in JavaScript ES6, is and how it is used with strings in JavaScript. The endsWith method is…

What are javascript symbols and how can they help you?

Symbols are a new primitive value introduced by ES6. Their purpose is to provide us unique identifiers. In this article, we tell you how they work, in which way they…

Callbacks in JavaScript

Callback functions are the same old JavaScript functions. They have no special syntax, as they are simply functions that are passed as an argument to another function. The function that receives…

How to create PDF with JavaScript and jsPDF

Creating dynamic PDF files directly in the browser is possible thanks to the jsPDF JavaScript library. In the last part of this article we have prepared a practical tutorial where I…

How to make your own custom cursor for your website

When I started browsing different and original websites to learn from them, one of the first things that caught my attention was that some of them had their own cursors,…

Node.js and npm: introductory tutorial

In this tutorial we will see how to install and use both Node.js and the npm package manager. In addition, we will also create a small sample application. If you…

How to connect to MySQL with Node.js

Let's see how you can connect to a MySQL database using Node.js, the popular JavaScript runtime environment. Before we start, it is important to note that you must have Node.js installed…

JavaScript Programming Styles: Best Practices

When programming with JavaScript there are certain conventions that you should apply, especially when working in a team environment. In fact, it is common to have meetings to discuss standards…

Difference between arrow and normal functions in JavaScript

In this tutorial we are going to see how arrow functions differ from normal JavaScript functions. We will also see when you should use one and when you should use…

JavaScript Arrow functions: What they are and how to use them

In this article we are going to see what they are and how to use JavaScript Arrow Functions, a new feature introduced with the ES6 standard (ECMAScript 6). What are Arrow…

How to insert an element into an array with JavaScript

In this brief tutorial you will learn how to insert one or more elements into an array with JavaScript. For this we will use the splice function. The splice function will not…

What is the difference between primitives types and objects in JavaScript?

In this short tutorial we are going to look at the differences between primitive types and objects in JavaScript. To start with, we're going to look at what primitive types…

We use our own and third-party cookies to improve our services, compile statistical information and analyze your browsing habits. This allows us to personalize the content we offer and to show you advertisements related to your preferences. By clicking "Accept all" you agree to the storage of cookies on your device to improve website navigation, analyse traffic and assist our marketing activities. You can also select "System Cookies Only" to accept only the cookies required for the website to function, or you can select the cookies you wish to activate by clicking on "settings".

Accept All Only sistem cookies Configuration