CKTIS / JavaScript
Array.prototype.shift: remoção do primeiro elemento
shift remove o índice zero, desloca as restantes propriedades para a esquerda e devolve o primeiro valor original.
Versão: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaxe
array.shift()array.shift() lê o índice 0, move cada propriedade existente seguinte uma posição para a esquerda, elimina a última posição, reduz length e devolve o valor lido. Um array vazio devolve undefined e define length como 0. As posições vazias são preservadas eliminando a propriedade de destino, não materializadas como undefined.
O método altera o recetor, tem custo linear num array comum e é genérico para objetos array-like modificáveis. Não recebe argumentos. Um recetor null ou undefined lança TypeError. Getter, setter, Proxy, propriedade só de leitura ou índice não configurável pode lançar um erro; deslocamentos anteriores não têm de ser revertidos, pelo que a alteração pode ser parcial.
Exemplos
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);Resultado
a b,c 2 undefined 3 0,2 b d x y 1 false