Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Array.prototype.shift: rimozione del primo elemento

shift rimuove l’indice zero, sposta le proprietà restanti a sinistra e restituisce il primo valore originale.

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

Sintassi

array.shift()

array.shift() legge l’indice 0, sposta ogni proprietà esistente successiva di una posizione a sinistra, elimina l’ultima posizione, riduce length e restituisce il valore letto. Un array vuoto restituisce undefined e imposta length a 0. I vuoti sono conservati eliminando la proprietà di destinazione e non materializzati come undefined.

Il metodo muta il ricevente, ha costo lineare per un array normale ed è generico per oggetti array-like modificabili. Non accetta argomenti. Un ricevente null o undefined genera TypeError. Getter, setter, Proxy, proprietà di sola lettura o indice non configurabile può generare un errore; gli spostamenti precedenti non devono essere annullati, quindi la modifica può restare parziale.

Esempi

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

Risultato

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

Fonti