Dieunshift() Methode vonArray Instanzen fügt die angegebenen Elemente am Anfang eines Arrays hinzu und gibt die neue Länge des Arrays zurück.

Probieren Sie es aus

const array = [1, 2, 3];console.log(array.unshift(4, 5));// Expected output: 5console.log(array);// Expected output: Array [4, 5, 1, 2, 3]

Syntax

unshift()unshift(element1)unshift(element1, element2)unshift(element1, element2, /* …, */ elementN)

Parameter

element1, …,elementN

Die Elemente, die dem Anfang desarr hinzugefügt werden sollen.

Rückgabewert

Die neuelength Eigenschaft des Objekts, auf das die Methode angewendet wurde.

Beschreibung

Dieunshift() Methode fügt die angegebenen Werte am Anfang eines array-ähnlichen Objekts ein.

Array.prototype.push() ähnelt dem Verhalten vonunshift(), aber es wird am Ende eines Arrays angewendet.

Bitte beachten Sie, dass, wenn mehrere Elemente als Parameter übergeben werden, sie als Block am Anfang des Objekts in der exakt gleichen Reihenfolge eingefügt werden, in der sie als Parameter übergeben wurden. Daher ergibt ein einmaliges Aufrufen vonunshift() mitn Argumentennicht dasselbe Ergebnis wien mal Aufrufen mit1 Argument (zum Beispiel in einer Schleife).

Siehe Beispiel:

let arr = [4, 5, 6];arr.unshift(1, 2, 3);console.log(arr);// [1, 2, 3, 4, 5, 6]arr = [4, 5, 6]; // resetting the arrayarr.unshift(1);arr.unshift(2);arr.unshift(3);console.log(arr);// [3, 2, 1, 4, 5, 6]

Dieunshift() Methode istgenerisch. Sie erwartet lediglich, dass derthis Wert einelength Eigenschaft und integer-integrierte Eigenschaften hat. Obwohl Zeichenfolgen auch array-ähnlich sind, ist diese Methode nicht geeignet, auf sie angewendet zu werden, da Zeichenfolgen unveränderlich sind.

Beispiele

Verwendung von unshift()

const arr = [1, 2];arr.unshift(0); // result of the call is 3, which is the new array length// arr is [0, 1, 2]arr.unshift(-2, -1); // the new array length is 5// arr is [-2, -1, 0, 1, 2]arr.unshift([-4, -3]); // the new array length is 6// arr is [[-4, -3], -2, -1, 0, 1, 2]arr.unshift([-7, -6], [-5]); // the new array length is 8// arr is [ [-7, -6], [-5], [-4, -3], -2, -1, 0, 1, 2 ]

Aufrufen von unshift() auf nicht-Array Objekten

Dieunshift() Methode liest dielength Eigenschaft vonthis. Sie verschiebt alle Indizes im Bereich von0 bislength - 1 nach rechts um die Anzahl der Argumente (indem ihre Werte um diese Zahl erhöht werden). Dann setzt sie jeden Index beginnend bei0 mit den anunshift() übergebenen Argumenten. Schließlich setzt sie dielength auf die vorherige Länge plus die Anzahl der hinzugefügten Elemente.

const arrayLike = {  length: 3,  unrelated: "foo",  2: 4,};Array.prototype.unshift.call(arrayLike, 1, 2);console.log(arrayLike);// { '0': 1, '1': 2, '4': 4, length: 5, unrelated: 'foo' }const plainObj = {};// There's no length property, so the length is 0Array.prototype.unshift.call(plainObj, 1, 2);console.log(plainObj);// { '0': 1, '1': 2, length: 2 }

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonArray.prototype.unshift incore-js mit Korrekturen dieser Methode
• es-shims Polyfill vonArray.prototype.unshift
• Indizierte Sammlungen Leitfaden
• Array
• Array.prototype.push()
• Array.prototype.pop()
• Array.prototype.shift()
• Array.prototype.concat()
• Array.prototype.splice()