Array.prototype.shift()

Сводка

Метод shift() удаляет первый элемент из массива и возвращает его значение. Этот метод изменяет длину массива.

Синтаксис

arr.shift()

Описание

Метод shift удаляет элемент по нулевому индексу, сдвигает значения по последовательным индексам вниз, а затем возвращает удалённое значение. Если свойство length массива равно 0, вернётся значение undefined.

Метод shift не является привязанным к типу; этот метод может быть вызван или применён к объектам, напоминающим массив. Объекты, не содержащие свойство length, отражающее последний элемент в серии последовательных числовых, начинающихся с нуля, свойств, могут повести себя неправильным образом.

Примеры

Пример: удаление элемента из массива

Следующий код показывает массив myFish до и после удаления его первого элемента. Также он показывает удалённый элемент:

js
var myFish = ["ангел", "клоун", "мандарин", "хирург"];

console.log("myFish до: " + myFish);
//myFish до: ангел,клоун,мандарин,хирург

var shifted = myFish.shift();

console.log("myFish после: " + myFish);
//myFish после: клоун,мандарин,хирург

console.log("Удалён этот элемент: " + shifted);
//Удалён этот элемент: ангел

Вывод этого примера будет следующим:

js
myFish до: ангел,клоун,мандарин,хирург
myFish после: клоун,мандарин,хирург
Удалён этот элемент: ангел

Спецификации

Specification
ECMAScript Language Specification
# sec-array.prototype.shift

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также