База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.shift: премахване на първия елемент

shift премахва индекс нула, измества останалите свойства наляво и връща първоначалната първа стойност.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

array.shift()

array.shift() прочита индекс 0, премества всяко следващо съществуващо свойство с една позиция наляво, изтрива последната позиция, намалява length и връща прочетената стойност. Празен масив връща undefined и задава length на 0. Дупките се запазват чрез изтриване на целевото свойство и не се материализират като undefined.

Методът променя получателя, има линейна цена за обикновен масив и е общ за изменяеми array-like обекти. Не приема аргументи. Получател null или undefined хвърля TypeError. Getter, setter, Proxy, свойство само за четене или неконфигурируем индекс може да хвърли грешка; предишните премествания не е задължително да се отменят, затова промяната може да е частична.

Примери

const values = ["a", "b", "c"];
console.log(values.shift(), values.join(","), values.length);
const sparse = [, "b", , "d"];
const first = sparse.shift();
console.log(first, sparse.length, Object.keys(sparse).join(","), sparse[0], sparse[2]);
const record = { 0: "x", 1: "y", length: 2 };
console.log(Array.prototype.shift.call(record), record[0], record.length, 1 in record);

Резултат

a b,c 2
undefined 3 0,2 b d
x y 1 false

Източници