CKTIS / JavaScript
Array.prototype.shift: usunięcie pierwszego elementu
shift usuwa indeks zero, przesuwa pozostałe właściwości w lewo i zwraca pierwotną pierwszą wartość.
Wersja: ECMAScript 2026 draft; example target: Node.js 24.22.2
Składnia
array.shift()array.shift() odczytuje indeks 0, dla kolejnych indeksów przenosi istniejącą właściwość o jedno miejsce w lewo, usuwa ostatnią pozycję, zmniejsza length i zwraca odczytaną wartość. Pusta tablica daje undefined i ustawia length na 0. Dziury są zachowywane przez usuwanie docelowej właściwości, a nie materializowane jako undefined.
Metoda mutuje odbiorcę, ma koszt liniowy dla zwykłej tablicy i jest generyczna dla modyfikowalnych obiektów array-like. Nie przyjmuje argumentów. Odbiorca null lub undefined powoduje TypeError. Getter, setter, Proxy, właściwość tylko do odczytu lub nieusuwalny indeks może zgłosić wyjątek; wcześniejsze przesunięcia nie muszą zostać cofnięte, więc modyfikacja może być częściowa.
Przykłady
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);Wynik
a b,c 2 undefined 3 0,2 b d x y 1 false