ChatGPT解决这个技术问题 Extra ChatGPT

How can I add new array elements at the beginning of an array in JavaScript?

I have a need to add or prepend elements at the beginning of an array.

For example, if my array looks like below:

[23, 45, 12, 67]

And the response from my AJAX call is 34, I want the updated array to be like the following:

[34, 23, 45, 12, 67]

Currently I am planning to do it like this:

var newArray = [];
newArray.push(response);

for (var i = 0; i < theArray.length; i++) {
    newArray.push(theArray[i]);
}

theArray = newArray;
delete newArray;

Is there a better way to do this? Does JavaScript have any built-in functionality that does this?

The complexity of my method is O(n) and it would be really interesting to see better implementations.

FYI: If you need to continuously insert an element at the beginning of an array, it is faster to use push statements followed by a call to reverse, instead of calling unshift all the time.
@JennyO'Reilly you should post this as an answer. Matched my use-case perfectly. thanks
Performance tests: jsperf.com/adding-element-to-the-array-start But the results are different for each browser.

M
Mak

Use unshift. It's like push, except it adds elements to the beginning of the array instead of the end.

unshift/push - add an element to the beginning/end of an array

shift/pop - remove and return the first/last element of an array

A simple diagram...

   unshift -> [array] <- push
   shift   <- [array] -> pop
 

and chart:

          add  remove  start  end
   push    X                   X
    pop           X            X
unshift    X             X
  shift           X      X

Check out the MDN Array documentation. Virtually every language that has the ability to push/pop elements from an array will also have the ability to unshift/shift (sometimes called push_front/pop_front) elements, you should never have to implement these yourself.

As pointed out in the comments, if you want to avoid mutating your original array, you can use concat, which concatenates two or more arrays together. You can use this to functionally push a single element onto the front or back of an existing array; to do so, you need to turn the new element into a single element array:

const array = [3, 2, 1] const newFirstElement = 4 const newArray = [newFirstElement].concat(array) // [ 4, 3, 2, 1 ] console.log(newArray);

concat can also append items. The arguments to concat can be of any type; they are implicitly wrapped in a single-element array, if they are not already an array:

const array = [3, 2, 1] const newLastElement = 0 // Both of these lines are equivalent: const newArray1 = array.concat(newLastElement) // [ 3, 2, 1, 0 ] const newArray2 = array.concat([newLastElement]) // [ 3, 2, 1, 0 ] console.log(newArray1); console.log(newArray2);


Using concat might be preferable as it returns the new array. Very useful for chaining. [thingToInsertToFront].concat(originalArray).reduce(fn).reverse().map(fn) etc... If you use unshift, you can't do that chaining because all you get back is the length.
shift/unshift, push/pop, splice. Very logical names for such methods.
This one of the most easy to understand answers that I ever seen. Congrats for that.
R
Ruslan López

https://i.stack.imgur.com/1pQk8.jpg

var a = [23, 45, 12, 67]; a.unshift(34); console.log(a); // [34, 23, 45, 12, 67]


The reason why people need a visual guideline for 4 everyday used functions is because of the encrypted function names... Why is unshift not called Insert? Shift should be Remove. etc...
//Why is unshift not called Insert?// It comes from the conventions of the C programming language where array elements were treated like a stack. (see perlmonks.org/?node_id=613129 for a complete explanation)
@Pascal No, insert and remove would be particularly bad names for this; they imply random access, instead of adding/removing from the front of the array
I would have thought that unshift should remove the first key, and shift would insert at the first key, but that's just my general thought
Mind that [23, 45, 12, 67].unshift(34) will not work. The Array must first be saved inside a variable, because unshift itself returns a value.
P
Peter Mortensen

With ES6, use the spread operator ...:

Demo

var arr = [23, 45, 12, 67]; arr = [34, ...arr]; // RESULT : [34,23, 45, 12, 67] console.log(arr)


also creates a new array, useful for pure functions
what is the performance implication here? Is it slower than using unshift()?
Sure, it will be slower since it is an immutable array ( creating a new array). If you are working with a big array or the performance is your first requirement, please consider to use concat instead.
performance is not important in 2018, new versions in browser and node get the same performance
@AbdennourTOUMI Just to clarify your comment. It is not creating an immutable array, it is just creating a new array without mutating the existing one.
P
Peter Mortensen

Another way to do that is through concat:

var arr = [1, 2, 3, 4, 5, 6, 7]; console.log([0].concat(arr));

The difference between concat and unshift is that concat returns a new array. The performance between them could be found here.

function fn_unshift() {
  arr.unshift(0);
  return arr;
}

function fn_concat_init() {
  return [0].concat(arr)
}

Here is the test result:

https://i.stack.imgur.com/f5u3L.png


It would be good for your answer to append the performance comparison of both apart from adding the reference.
I just got jsPerf is temporarily unavailable while we’re working on releasing v2. Please try again later from the link. Another good reason to include the results instead of linking to them.
jsPref result: unshift: 25,510 ±3.18% 99% slower concat: 2,436,894 ±3.39% fastest
In the latest Safari, fn_unshift() runs faster.
In the latest Safari (v 10), fn_unshift() is slower again.
d
dreftymac

Quick Cheatsheet:

The terms shift/unshift and push/pop can be a bit confusing, at least to folks who may not be familiar with programming in C.

If you are not familiar with the lingo, here is a quick translation of alternate terms, which may be easier to remember:

* array_unshift()  -  (aka Prepend ;; InsertBefore ;; InsertAtBegin )     
* array_shift()    -  (aka UnPrepend ;; RemoveBefore  ;; RemoveFromBegin )

* array_push()     -  (aka Append ;; InsertAfter   ;; InsertAtEnd )     
* array_pop()      -  (aka UnAppend ;; RemoveAfter   ;; RemoveFromEnd ) 

P
Peter Mortensen

Using ES6 destructuring (avoiding mutation off the original array):

const newArr = [item, ...oldArr]


Essentially a duplicate answer of the one by Abdennour TOUMI...
k
kabirbaidhya

Without Mutating

Actually, all unshift/push and shift/pop mutate the source array.

The unshift/push add an item to the existed array from begin/end and shift/pop remove an item from the beginning/end of an array.

But there are few ways to add items to an array without a mutation. the result is a new array, to add to the end of array use below code:

const originArray = ['one', 'two', 'three'];
const newItem = 4;

const newArray = originArray.concat(newItem); // ES5
const newArray2 = [...originArray, newItem]; // ES6+

To add to begin of original array use below code:

const originArray = ['one', 'two', 'three'];
const newItem = 0;

const newArray = (originArray.slice().reverse().concat(newItem)).reverse(); // ES5
const newArray2 = [newItem, ...originArray]; // ES6+

With the above way, you add to the beginning/end of an array without a mutation.


I just put an slice function at the end of originArray to prevent it from mutability.
Awesome! When comes to (Redux) State management... this answer is precious!
[newItem, ...originArray]; // ES6+ Is great syntax ! Worked perfect !! thanks.
P
Peter Mortensen

You have an array: var arr = [23, 45, 12, 67];

To add an item to the beginning, you want to use splice:

var arr = [23, 45, 12, 67]; arr.splice(0, 0, 34) console.log(arr);


arr.splice(0, arr.length, 34);
@LiorElrom what does your snippet do?
@poushy it's browser specific, in Firefox 54 is unshift 50% faster (but mostly more readable)
@poushy Not anymore. Way slower.
k
kabirbaidhya

Cheatsheet to prepend new element(s) into the array

1. Array#unshift

const list = [23, 45, 12, 67]; list.unshift(34); console.log(list); // [34, 23, 45, 12, 67];

2. Array#splice

const list = [23, 45, 12, 67]; list.splice(0, 0, 34); console.log(list); // [34, 23, 45, 12, 67];

3. ES6 spread...

const list = [23, 45, 12, 67]; const newList = [34, ...list]; console.log(newList); // [34, 23, 45, 12, 67];

4. Array#concat

const list = [23, 45, 12, 67]; const newList = [32].concat(list); console.log(newList); // [34, 23, 45, 12, 67];

Note: In each of these examples, you can prepend multiple items by providing more items to insert.


K
Krisztián Balla

If you need to continuously insert an element at the beginning of an array, it is faster to use push statements followed by a call to reverse, instead of calling unshift all the time.

Benchmark test: http://jsben.ch/kLIYf


Note: initial array should be empty.
In 2021 your benchmark shows a comprehensive win for unshift across all major desktop browsers (at least on this Mac).
@OllyHodgson testing on Ubuntu Linux with Firefox: reverse solution is 3-times faster.
I
Itay Grudev

Using splice we insert an element to an array at the begnning:

arrName.splice( 0, 0, 'newName1' );

P
Peter Mortensen

If you want to push elements that are in an array at the beginning of your array, use <func>.apply(<this>, <Array of args>):

const arr = [1, 2]; arr.unshift.apply(arr, [3, 4]); console.log(arr); // [3, 4, 1, 2]


R
Ran Turner

There are a couple of ways to achieve this:

Using shift (mutable)

const num = 1; const arr = [2, 3]; arr.unshift(num); console.log(arr);

Using ES6 destructuring (immutable)

const num = 1; const arr = [2, 3]; const newArr = [num, ...arr]; console.log(newArr);

Using Array.prototype.concat (immutable)

const num = 1; const arr = [2, 3]; const newArr = [num].concat(arr); console.log(newArr);


S
Sahil Thummar

let arr = [5, 6]; // using unshift arr.unshift(4); console.log('arr : ', arr); // using spread operator arr = [3, ...arr]; console.log('arr : ', arr); // using concat arr = [2].concat(arr); console.log('arr : ', arr); // using splice arr.splice(0, 0, 1) console.log('arr : ', arr);