JavaScript: Das umfassende Referenzwerk, Sixth Edition

Name

Array.shift() — Schiebt Array-Elemente nach untenorm:availability:

Überblick

array.shift()

Rückgabewert

Das vormals erste Array-Element.

Beschreibung

shift() entfernt und liefert das erste Element von array. Alle Folgeelemente werden um eins nach unten verschoben, um den frei gewordenen Platz am Array-Anfang wieder zu füllen. Wenn das Array leer ist, macht shift() überhaupt nichts und gibt den Wert undefined zurück. shift() erzeugt kein neues Array, sondern modifiziert unmittelbar das array.

shift() ist wie Array.pop(), operiert jedoch auf dem Anfang und nicht auf dem Ende des Arrays. Diese Methode wird oft zusammen mit unshift() eingesetzt.

Beispiel

var a = [1, [2,3], 4]; a.shift(); // Gibt 1 zurück; a = [[2,3], 4]. a.shift(); // Gibt [2,3] zurück; ...