--- title: Array.prototype.shift() slug: Web/JavaScript/Reference/Global_Objects/Array/shift tags: - Array - JavaScript - Method - Prototype translation_of: Web/JavaScript/Reference/Global_Objects/Array/shift ---
Метод shift()
удаляет первый элемент из массива и возвращает его значение. Этот метод изменяет длину массива.
arr.shift()
Метод shift
удаляет элемент по нулевому индексу, сдвигает значения по последовательным индексам вниз, а затем возвращает удалённое значение. Если свойство {{jsxref("Array.length", "length")}} массива равно 0, вернётся значение {{jsxref("Global_Objects/undefined", "undefined")}}.
Метод shift
не является привязанным к типу; этот метод может быть {{jsxref("Function.call", "вызван", "", 1)}} или {{jsxref("Function.apply", "применён", "", 1)}} к объектам, напоминающим массив. Объекты, не содержащие свойство length
, отражающее последний элемент в серии последовательных числовых, начинающихся с нуля, свойств, могут повести себя неправильным образом.
Следующий код показывает массив myFish
до и после удаления его первого элемента. Также он показывает удалённый элемент:
var myFish = ['ангел', 'клоун', 'мандарин', 'хирург']; console.log('myFish до: ' + myFish); //myFish до: ангел,клоун,мандарин,хирург var shifted = myFish.shift(); console.log('myFish после: ' + myFish); //myFish после: клоун,мандарин,хирург console.log('Удалён этот элемент: ' + shifted); //Удалён этот элемент: ангел
Вывод этого примера будет следующим:
myFish до: ангел,клоун,мандарин,хирург myFish после: клоун,мандарин,хирург Удалён этот элемент: ангел
Спецификация | Статус | Комментарии |
---|---|---|
ECMAScript 3-е издание. | Стандарт | Изначальное определение. Реализована в JavaScript 1.2. |
{{SpecName('ES5.1', '#sec-15.4.4.9', 'Array.prototype.shift')}} | {{Spec2('ES5.1')}} | |
{{SpecName('ES6', '#sec-array.prototype.shift', 'Array.prototype.shift')}} | {{Spec2('ES6')}} |
{{Compat}}