Array.prototype.unshift()

unshift() 메소드(method)는  새로운 요소(element)를 배열(array)의 맨 앞쪽에 추가하고자 할 때 사용한다. return 값은 새로운 요소가 추가된 배열이다. 

문법

arr.unshift([element1[, ...[, elementN]]])

파라미터

elementN

배열 맨 앞에 추가할 요소들.

반환값

새로운 배열의 length 속성.

설명

unshift 메소드는 배열 과 같은 객체의 시작점에 주어진 값(요소)을 삽입한다.

unshift is intentionally generic; this method can be called or applied to objects resembling arrays. Objects which do not contain a length property reflecting the last in a series of consecutive, zero-based numerical properties may not behave in any meaningful manner.

예제

var arr = [1, 2];

arr.unshift(0); // result of call is 3, the new array length
// arr is [0, 1, 2]

arr.unshift(-2, -1); // = 5
// arr is [-2, -1, 0, 1, 2]

arr.unshift([-3]);
// arr is [[-3], -2, -1, 0, 1, 2]

명세

브라우저 호환성

참조

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.shift()