## DEV Community is a community of 756,027 amazing developers

We're a place where coders share, stay up-to-date and grow their careers.

capscode

Posted on • Updated on • Originally published at capscode.in

# Array.flat() in JavaScript

Hello Devs,

In this article i will walk you through one of the important methods of Array in JavaScript i.e Array.flat method.

## Table of content

So without wasting any time lets get into the article

## Theory

The flat() method is used to flatten the array of arrays. The process of flatten depends on the depth we want to flattened the array of arrays.

What this method do is, it takes out the array element from an array of arrays and concat them in the main array.
it will repeat this process till the depth value.

## Syntax

``````Syntax:
flat(depth)
// The depth level specifying how deep a nested array structure should be flattened.
// Defaults to 1.
``````

## Return Value

``````return value:
A new array with the sub-array elements concatenated into it.
``````

## Examples

NOTE: IF YOU WANT TO FLATTEN THE ARRAY UPTO ITS LAST DEPTH THEN PUT `depth` AS `Infinity`

``````example:
let arr = [1, 2, [3, 4, [5, 6]]];

arr.flat(0) // [1, 2, [3, 4, [5, 6]]];
arr.flat(1) // [1, 2, 3, 4, [5, 6]]
arr.flat(2) // [1, 2, 3, 4, 5, 6]
arr.flat(3) // [1, 2, 3, 4, 5, 6]
arr.flat( ) // [1, 2, 3, 4, [5, 6]]
// if no depth is provided then it will take the default value i.e 1.
arr.flat(Infinity) //[1, 2, 3, 4, 5, 6]

arr.flat(0).length //3
arr.flat(1).length //5
arr.flat(2).length //6

``````

Thank you for reading this far. This is a brief introduction of Array.flat() method in JavaScript .

Hope its a nice and informative read for you.
See you in my next Blog article, Take care!!

Thanks,
@capscode

## Discussion (9)

Amit Mondal • Edited on

Great!
Just wanted to add one more

arr.flat(Infinity); // to flatten the whole array upto it's last depth.

capscode

Wow, i didnt know that..
thank you :)

capscode

i am going to add this in this blog itself :)

Charlie J Smotherman

Couldn't resist
Short and sweet nice 👍

capscode

hahaha
Thank You :)

Jash Gopani

wow, nice article ! short and to the point 👌

capscode

Thank you so much :)

Andrew Baisden

Good explanation thanks for taking the time to create and share this info.

capscode

You are most welcome, and thanks to you as well for liking my post and found this valuable.
:)