Array.prototype.shift()

Zusammenfassung

Die Methode shift() entfernt das erste Element eines Arrays und gibt dieses Element zurück. Diese Methode verändert die Größe des Arrays.

Syntax

arr.shift()

Beschreibung

Die Method shift entfernt das Element an der nullten Stelle, verschiebt die übrigen Elemente im Index gegen Null, und liefert den Wert des entfernten Elementes zurück. Hat die Eigenschaft length den Wert 0, wird undefined zurück gegeben.

shift ist absichtlich generisch; denn diese Methode kann auf Objekt-Arrays aufgerufen oder angewandt werden. Objekte, die nicht über die Eigenschaft length verfügen, welche nicht das letzte in einer Reihe aufeinander folgenden, null-basierenden nummerische Werten repräsentieren, können sinnlose Ergebnisse liefern.

Beispiele

Ein Element eines Arrays entfernen

Das folgende Skript zeigt das Array myFish bevor und nachdem das erste Element dieses Arrays entfernt wurde. Anschließend wird das entfernte Element angezeigt:

var myFish = ['angel', 'clown', 'mandarin', 'surgeon'];

console.log('myFish bevor: ' + myFish);

var shifted = myFish.shift();

console.log('myFish nachdem: ' + myFish);
console.log('Entferntes Element: ' + shifted);

Dieses Beispiel führt zu der folgenden Ausgabe in der Browser-Konsole:

myFish bevor: angel,clown,mandarin,surgeon
myFish nachdem: clown,mandarin,surgeon
Entferntes Element: angel

Specifications

Browser compatibility

See also

• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.unshift()