Array.prototype.shift()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Сводка
Методshift()
удаляетпервый элемент из массива и возвращает его значение. Этот метод изменяет длину массива.
Синтаксис
arr.shift()
Описание
Методshift
удаляет элемент по нулевому индексу, сдвигает значения по последовательным индексам вниз, а затем возвращает удалённое значение. Если свойствоlength
массива равно 0, вернётся значениеundefined
.
Методshift
не является привязанным к типу; этот метод может бытьвызван илиприменён к объектам, напоминающим массив. Объекты, не содержащие свойствоlength
, отражающее последний элемент в серии последовательных числовых, начинающихся с нуля, свойств, могут повести себя неправильным образом.
Примеры
Пример: удаление элемента из массива
Следующий код показывает массивmyFish
до и после удаления его первого элемента. Также он показывает удалённый элемент:
var myFish = ["ангел", "клоун", "мандарин", "хирург"];console.log("myFish до: " + myFish);//myFish до: ангел,клоун,мандарин,хирургvar shifted = myFish.shift();console.log("myFish после: " + myFish);//myFish после: клоун,мандарин,хирургconsole.log("Удалён этот элемент: " + shifted);//Удалён этот элемент: ангел
Вывод этого примера будет следующим:
myFish до: ангел,клоун,мандарин,хирургmyFish после: клоун,мандарин,хирургУдалён этот элемент: ангел
Спецификации
Specification |
---|
ECMAScript® 2026 Language Specification # sec-array.prototype.shift |