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 2015년 7월.

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]

구문

arr.unshift([...elementN]);

매개변수

elementN

배열 맨 앞에 추가할 요소.

반환 값

메서드를 호출한 배열의 새로운 length 속성.

설명

unshift 메서드는 배열 형태의 객체 시작점에 주어진 값을 삽입합니다.

unshift는 제네릭하도록 설계되었으며, 배열 형태를 가진 객체가 호출하거나 객체에 적용할 수 있습니다. length 속성을 가지지 않고, 대신 마지막 요소를 0부터 시작하는 순차적 인덱스로만 나타내는 객체에서는 의도한 것과 다르게 행동할 수 있습니다.

예제

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® 2027 Language Specification
# sec-array.prototype.unshift

브라우저 호환성

Enable JavaScript to view this browser compatibility table.

같이 보기

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025년 10월 10일 by MDN contributors.

View this page on GitHub • Report a problem with this content

표준 내장 객체
Array
생성자
1. Array()
정적 메서드
정적 속성
1. [Symbol.species]
인스턴스 메서드
인스턴스 속성
1. length
2. [Symbol.unscopables]
상속
Object/Function
정적 메서드
정적 속성
인스턴스 메서드
인스턴스 속성
1. Object.prototype.__proto__
2. Object.prototype.constructor

Array.prototype.unshift()

In this article

Help improve MDN