Array.prototype.unshift()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
unshift() 메서드는 새로운 요소를 배열의 맨 앞쪽에 추가하고, 새로운 길이를 반환합니다.
시도해 보기
const array1 = [1, 2, 3];
console.log(array1.unshift(4, 5));
// Expected output: 5
console.log(array1);
// Expected output: Array [4, 5, 1, 2, 3]
구문
js
arr.unshift([...elementN]);
매개변수
elementN-
배열 맨 앞에 추가할 요소.
반환 값
메서드를 호출한 배열의 새로운 length 속성.
설명
예제
js
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]
명세
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.unshift |