Array.prototype.shift()

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

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

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

Синтаксис

arr.shift()

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

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

Опис

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

shift є загальним навмисно; Цей метод може бути викликаний чи застосований до схожих із масивами об'єктів. Об'єкти, які не містять 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"

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

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

Дивись також

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.unshift()
• Array.prototype.concat()