Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.shift: odebrání prvního prvku

shift odstraní index nula, posune zbývající vlastnosti doleva a vrátí původní první hodnotu.

Verze: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntaxe

array.shift()

array.shift() přečte index 0, přesune každou další existující vlastnost o jednu pozici doleva, odstraní poslední pozici, sníží length a vrátí přečtenou hodnotu. Prázdné pole vrátí undefined a nastaví length na 0. Díry se zachovají odstraněním cílové vlastnosti a nematerializují se jako undefined.

Metoda mění příjemce, u běžného pole má lineární cenu a je obecná pro měnitelné array-like objekty. Nepřijímá argumenty. Příjemce null nebo undefined vyvolá TypeError. Getter, setter, Proxy, vlastnost jen pro čtení nebo nekonfigurovatelný index může vyvolat chybu; dřívější přesuny se nemusejí vrátit zpět, takže změna může být částečná.

Příklady

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);

Výsledek

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

Zdroje