WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.shift: erstes Element entfernen

shift entfernt Index null, verschiebt übrige Eigenschaften nach links und liefert den ursprünglichen ersten Wert.

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

Syntax

array.shift()

array.shift() liest Index 0, verschiebt jede folgende vorhandene Eigenschaft um eine Position nach links, löscht die letzte Position, verringert length und liefert den gelesenen Wert. Ein leeres Array liefert undefined und setzt length auf 0. Lücken bleiben durch Löschen der Zieleigenschaft erhalten und werden nicht als undefined materialisiert.

Die Methode mutiert den Empfänger, hat bei einem normalen Array lineare Kosten und ist für veränderliche array-ähnliche Objekte generisch. Sie nimmt keine Argumente an. null oder undefined als Empfänger löst TypeError aus. Getter, Setter, Proxy, schreibgeschützte Eigenschaft oder nicht konfigurierbarer Index kann einen Fehler auslösen; frühere Verschiebungen werden nicht zwingend zurückgerollt, daher kann die Änderung teilweise bleiben.

Beispiele

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

Ergebnis

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

Quellen