Array
In JavaScript, arrays aren't primitives but are instead Array objects with the following core characteristics:
JavaScript arrays are resizable and can contain a mix of different data types.(If you want an array only contains one type of variables, use typed arrays instead. -- Int8Array, Uint8Array.etc.)
JavaScript arrays are not associative arrays(key value pairs data structure like map), so it must be accessed using integers as indexes.
JavaScript arrays start at 0 index
JavaScript array-copy operations create shallow copies
1. Array-copy operations
- spread syntax
const fruits = ["Strawberry", "Mango"];
const fruitsCopy = [...fruits];
- from( ) method
const fruits = ["Strawberry", "Mango"];
const fruitsCopy = Array.from(fruits);
- slice( ) method
const fruits = ["Strawberry", "Mango"];
const fruitsCopy = fruits.slice();
All the array-copy operations above are implemented by copying each element's value to the new array. When an array contains reference type elements, these operations will only copy the reference of these elements instead of saving the copies in a new memory space.
2. Shallow copy & Deep copy
- shallow copy A shallow copy of an object is a copy whose properties share the same references as those of the source object from which the copy was made. As a result, when you change either the source or the copy, you may also cause the other object to change too.
let arr = [[1, 2, 3], 4, 5, 6];
let arrCopy = [...arr];
// or arr.from() or arr.slice()
arrCopy[0][2] = 4;
console.log(arr); // [[1, 2, 4], 4, 5, 6]
// original array has been modified. This is because the reference of arr[0] and arrCopy[0] is the same. So no matter which of them has been changed, the other one will also be changed.
- deep copy A deep copy of an object is a copy whose properties do not share the same references as those of the source object from which the copy was made. As a result, when you change either the source or the copy, you can be assured you're not causing the other object to change too. One way to make a deep copy of a JavaScript object is to use JSON.stringify() to convert the object to a JSON string, and then JSON.parse() to convert the string back into a completely new JavaScript object.
const fruits = ["Strawberry", "Mango"];
const fruitsDeepCopy = JSON.parse(JSON.stringify(fruits));
Array Methods
- concat( )
The
concat()
method is used to merge two or more arrays. This method does not change the existing arrays, but instead returns a new array.
let arr1 = [1, 2, 3];
let arr2 = [4, 5, 6];
let arr3 = arr1.concat(arr2);
console.log(arr3); // [1,2,3,4,5,6]
- every( )
The
every()
method tests whether all elements in the array pass the test implemented by the provided function. It returns a Boolean value.
function func(value) {
return value < 4;
}
let arr = [1, 2, 3];
console.log(arr.every(func)); //true
-
fill( )
Thefill()
method changes all elements in an array to a static value, from a start index(default0
) to an end index(defaultarray.length
). It returns the mmodified array. Syntax:-
fill(value)
Value to fill the array with. (All elements in the array will be this exact value.)
-
let arr = [1, 2, 3];
arr.fill(6);
console.log(arr); //[6,6,6]
-
fill(value, start)
Start index(inclusive), default0
.
let arr = [1, 2, 3];
arr.fill(6, 1);
console.log(arr); //[1,6,6]
-
fill(value, start, end)
End index(exclusive), defaultarr.length
.
let arr = [1, 2, 3];
arr.fill(6, 1, 2);
console.log(arr); //[1,6,3]
- filter( )
The
filter()
method creates a new array with all elements that pass the test implemented by the provided function.
function func(value) {
return value <= 2;
}
let arr = [1, 2, 3];
let filteredArr = arr.filter(func);
console.log(filteredArr); //[1,2]
- find( )
The
find()
method returns the first element in the provided array that satisfies the provided testing function. If no values satisfy the testing function,undefined
is returned.
let arr = [1, 2, 3];
const found = arr.find((element) => element > 2);
console.log(found); // 3
- findIndex( )
The
findIndex()
method returns the index of the first element in the array that satisfies the provided testing function. Otherwise, it returns-1
, indicating that no element passed the test.
let arr = [1, 2, 3];
const foundIndex = arr.findIndex((element) => element > 2);
console.log(foundIndex); // 2
-
flat( )
Theflat()
method creates a new array with all sub-array elements concatenated into it recursively up to the specified depth.-
flat(depth)
The depth level specifying how deep a nested array structure should be flattend. Defaults to 1.
let arr = [1, 2, 3, [[4, 5]]]; console.log(arr.flat()); // depth = 1, [1,2,3,[4,5]] console.log(arr.flat(2)); // [1,2,3,4,5]
-
forEach( )
TheforEach()
method executes a provided function once for each array element.
let arr = [1, 2, 3];
arr.forEach((element) => console.log(element * element)); // 1,4,9
- includes( )
The
includes()
method determines whether an array includes a certain value among its entries, returningtrue
orfalse
as appropriate.
let arr = [1, 2, 3];
console.log(arr.includes(2)); // true
console.log(arr.includes(4)); // false
- join( )
The
join()
method creates and returns a new string by concatenating all of the elements in an array, separated by commas or a specified separator string. If the array has only one item, then that item will be returned without using the separator.
const elements = ["Fire", "Air", "Water"];
console.log(elements.join());
// expected output: "Fire,Air,Water"
console.log(elements.join(""));
// expected output: "FireAirWater"
console.log(elements.join("-"));
// expected output: "Fire-Air-Water"
- map( )
The
map()
method creates a new array populated with the results of calling a provided function on every element in the calling array.
let arr = [1, 2, 3];
let newArr = arr.map((element) => element * 2);
console.log(newArr); // [2,4,6]
- flatMap( )
The
flatMap()
method returns a new array formed by applying a given callback function to each element of the array, and then flattening the result by one level. It is identical to amap()
followed by aflat()
of depth 1, but slightly more efficient than calling those two methods separately.
let arr = [1, 2, 3];
let newArr = arr.flatMap((element) => [element * 2]);
console.log(newArr); // [2,4,6]
let newArr = arr.flatMap((element) => [[element * 2]]);
console.log(newArr); // [[2],[4],[6]]
- pop( )
The
pop()
method removes the last element from an array and returns that element. This method changes the length of the array.
let arr = [1, 2, 3];
let lastElement = arr.pop();
console.log(arr, lastElement); // [1,2] 3
- push( )
The
push()
method adds one or more elements to the end of an array and returns the new length of the array.
let arr = [1, 2, 3];
let length = arr.push(4, 5, 6);
console.log(length, arr); // 6 [1,2,3,4,5,6]
- reduce( )
The
reduce()
method executes a reducer function on each element of the array and returns a singel output value. The syntax of thereduce()
method is:
reduce(function (accumulator, currentValue, currentIndex, array) {
// callback - The function to execute on each array element(except the first element if no `initialValue` is provided). It takes in:
// accumulator - It accumulates the callback's return values.
// currentValue - The current element being passed from the array.
// currentIndex is the index of the current value within the array.
// array is a reference to the array reduce works on
// initialValue(optional) - A value that will be passed to `callback()` on first call. If not provided, the first element acts as the `accumulator` on the first call and `callback()` won't execute on it.
}, initialValue);
Note:
- Calling
reduce()
on an empty array withoutinitialValue
will throwTyepError
. -
reduce()
executes the given function for each value of the array from left to right. -
reduce()
does not change the original array. - It is almost always safer to provide
initialValue
.
###
Examples to explain reduce()
in details.
// If there is no callback, reduce method return the value of initialValue.
let value = [].reduce(() => {}, 2);
console.log(value); // 2
// If there is no initialValue, the first element of the array will be taken as the accumulator and callback function starts at the second element.
value = [1, 0].reduce((accumulator, currentValue, currentIndex, arr) => {
console.log(
`callback: ${accumulator}, ${currentValue}, ${currentIndex}. arr: ${arr}`
); // callback: 1, 0, 1. arr: 1,0
return accumulator + currentValue + currentIndex;
});
console.log(value); // 2
Array.reduce( ) - programiz
Array.reduce( ) - oliver Jumpertz blog
- reverse( )
The
reverse()
method reverses an array in place(In computer science, an in-place algorithm is an algorithm which transforms input using no auxiliary data structure).
let arr = [1, 2, 3];
console.log(arr.reverse()); // [3,2,1]
- shift( )
The
shift()
method removes the first element from an array and returns that removed element. The method changes the length of the array.
let arr = [1, 2, 3];
let firstElement = arr.shift();
console.log(`firstElement: ${firstElement}, arr: ${arr}`); // firstElement: 1, arr: 2,3
- some( )
The
some()
method tests whether at least one element in the array passes the test implemented by the provided function. It returns true if, in the array, it finds an element for which the provided function returns true; otherwise it returns false. It doesn't modify the array.
let arr = [1, 2, 3];
console.log(arr.some((element) => element % 2 === 0)); // true
-
sort( )
Thesort()
method sorts the elements of an array in place and returns the sorted array.- sort from min to max(Default)
let arr = [1, 2, 3]; console.log(arr.sort()); // [1,2,3] console.log(arr.sort((a, b) => a - b)); // [1,2,3]
- sort from max to min
let arr = [1, 2, 3]; console.log(arr.sort((a, b) => b - a)); // [3,2,1]
unshift( )
Theunshift()
method adds one or more elements to the beginning of an array and returns the new length of the array.
let arr = [4, 5];
let length = arr.unshift(1, 2, 3);
console.log(`length: ${length}, arr: ${arr}`); // length: 5, arr: [1,2,3,4,5]
-
splice( )
Thesplice()
method changes the contents of an array by removing or replacing existing elements and/or adding new elements in place. It returns an array which conains the deleted elements.
Syntax: splice(start, deleteCount, item1, item2, itemN)- start - The index at which to start changing the array. If greater than the length of the array,
start
will be set to the length of the array. In this case, no element will be deleted but the method will behave as an adding function, adding as many elements as items provided. If negative, it will begin that many elements from the end of the array. (In this case, the origin-1
, meaning-n
is the index of then
th last elemtent, and is therefore equivalent to the index ofarray.length - n
.) Ifstart
isnegative infinity
, it will begin from index0
.
- start - The index at which to start changing the array. If greater than the length of the array,
// start > array.length: act like an adding method
arr = [1, 2, 3];
let value = arr.splice(4, 0, "changed"); // deleteCount must have a value
console.log(value, arr); // [] [1,2,3,'changed']
// start < 0: start = array.length - start
arr = [1, 2, 3];
arr.splice(-2, 1, "changed");
console.log(arr); // [1, 'changed', 3] (start = 1)
arr.splice(Number.NEGATIVE_INFINITY, 1, "changed"); // [ 'changed', 'changed', 3 ]
- deleteCount - An integer indicating the number of elements in the array to remove from
start
. IfdeleteCount
is omitted, or if its value is equal to or larger thanarray.length - start
, then all the elements fromstart
to the end of the array will be deleted. However, it must not be omitted if there is anyitem1
parameter. IfdeleteCount
is0
or negative, no elements are removed. In this case, you should specify at least one new element.
// deleteCount is omitted or its value >= array.length - start
// all the elements from start to the end of the array will be deleted
let arr = [1, 2, 3];
arr.splice(1); // [1]
arr.splice(2); // [1,2]
arr.splice(3); // [1,2,3]
arr.splice(1, 4); // [1]
// deleteCount <= 0
arr = [1, 2, 3];
arr.splice(1, 0, 1.5); // [ 1, 1.5, 2, 3 ]
arr.splice(1, -1, 1.5); // [ 1, 1.5, 2, 3 ]
- item1, item2, ... - The elements to add to the array, beginning from
start
. If you do not specify any elements,splice()
will only remove elements from the array.
// If you don't specify any elements, splice() will only remove
let arr = [1, 2, 3];
arr.splice(1, 1); // [1,3]
Top comments (2)
Great explanation arrays are one of the core data structures for building anything in JavaScript.
Hi Andrew, thanks for the comment :)
Yeah, totally agree. Arrays are very important in JS, and some of the subtle concepts in it are also very easy to get misunderstood. Like when someone wants to copy an array, even she/he uses the common array-copy operations, the original array can still be changed by changing the copied array. It is because the common array-copy operations are all shallow copy methods instead of deep copy methods.
I'm still very new with JS. The more I learn, the more I realize that JS is actually an easy-to-start but hard-to-master language. The flexibility it brings us also causes many quirky parts of the language. So now I try to relearn all of the fundamentals and hope I can be better at it in the futureπ