--- title: Array.prototype.shift() slug: Web/JavaScript/Reference/Global_Objects/Array/shift translation_of: Web/JavaScript/Reference/Global_Objects/Array/shift ---
{{JSRef}}

Метод shift() видаляє перший елемент з масиву і повертає цей елемент. Цей метод змінює довжину масиву.

var a = [1, 2, 3];
a.shift();

console.log(a); // [2, 3]

Синтаксис

arr.shift()

Повернене значення

Видалений елемент.

Опис

Метод shift видаляє елемент із нульовим індексом і  зсуває значення з послідовними індексами назад, потім повертає видалене значення. Якщо {{jsxref("Array.length", "length")}} властивість рівна 0, {{jsxref("undefined")}} повертається.

shift є загальним навмисно; Цей метод може бути {{jsxref("Function.call", "викликаний", "", 1)}} чи {{jsxref("Function.apply", "застосований", "", 1)}} до схожих із масивами об'єктів. Об'єкти, які не містять length властивості, що відображає кінець послідовного ряду, базовані на нулі числові властивості можуть себе вести беззмістовним чином.

Приклади

Видалення елементу з масиву

Поданий нижче код відображає myFish масив до і після видалення його першого елементу. Також він відображає видалений елемент.

var myFish = ['angel', 'clown', 'mandarin', 'surgeon'];

console.log('myFish before: ' + myFish);
// "myFish before: angel,clown,mandarin,surgeon"

var shifted = myFish.shift();

console.log('myFish after: ' + myFish);
// "myFish after: clown,mandarin,surgeon"

console.log('Removed this element: ' + shifted);
// "Removed this element: angel"

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

Специфікація Cтатус Коментар
{{SpecName('ES3')}} {{Spec2('ES3')}} Початкове визначення. Впроваджено в 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')}}
{{SpecName('ESDraft', '#sec-array.prototype.shift', 'Array.prototype.shift')}} {{Spec2('ESDraft')}}

Браузерна сумісність

{{CompatibilityTable}}
Браузер Chrome Firefox (Gecko) Edge Internet Explorer Opera Safari
Базова підтримка {{CompatChrome("1.0")}} {{CompatGeckoDesktop("1.7")}} {{CompatVersionUnknown}} {{CompatIE("5.5")}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}
Браузер Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базова підтримка {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}} {{CompatVersionUnknown}}

Дивись також