Name

Array.unshift() — Fügt am Array-Anfang Elemente einorm:availability:

Überblick

array.unshift(value, ...)

Argumente

value, ...

Ein oder mehr Werte, die am Anfang von array eingefügt werden sollen.

Rückgabewert

Die neue Länge des Arrays.

Beschreibung

Die Methode unshift() fügt ihre Argumente am Anfang von array ein und verschiebt dabei die vorhandenen Elemente auf nachfolgende Indexpositionen, um Platz zu schaffen. Das erste Argument von shift() wird nun das Array-Element mit dem Index 0; das zweite Element wird, falls vorhanden, das Element 1 und so weiter. Beachten Sie, dass unshift() kein neues Array anlegt, sondern das vorhandene array unmittelbar modifiziert.

Beispiel

unshift() wird oft zusammen mit shift() verwendet. Ein Beispiel:

var a = []; ...

Get JavaScript: Das umfassende Referenzwerk, Sixth Edition now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.