WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.unshift: am Anfang hinzufügen

unshift verschiebt vorhandene Indizes nach rechts, fügt Argumente vorn ein und gibt die neue Länge des Empfängers zurück.

Version: ECMAScript 1 onward; example target: Node.js 24.22.2

Syntax

array.unshift(...items)

array.unshift(...items) mutiert array: Vorhandene indizierte Eigenschaften werden um die Argumentzahl zu höheren Indizes verschoben, items ab Index null geschrieben und length aktualisiert. Die neue Länge wird zurückgegeben; die Argumentreihenfolge bleibt erhalten, also steht bei unshift("a", "b") das a vor b. Ohne Argumente bleibt die Länge gleich.

Lücken bleiben beim Verschieben erhalten: Fehlt eine Quelleigenschaft, wird die entsprechende Zieleigenschaft gelöscht. Die Methode ist für veränderbare array-ähnliche Objekte generisch und erzeugt kein Ergebnisarray.

Würde die neue Länge 2^53 - 1 überschreiten, entsteht TypeError; gewöhnliche Arrays haben eine weitere Längengrenze. Nicht schreibbare Indizes oder length, nicht löschbare Eigenschaften und Fehler von Gettern, Settern oder Proxy-Traps können den Vorgang nach Teiländerungen abbrechen. Das API besteht seit ECMAScript 1.

Beispiele

const queue = ["test", "deploy"];
const length = queue.unshift("lint", "build");
console.log(length, queue.join(","));

const sparse = [, "b"];
const sparseLength = sparse.unshift("a");
console.log(sparseLength, 0 in sparse, 1 in sparse, 2 in sparse, sparse[0], sparse[2]);

const arrayLike = { 1: "second", length: 2 };
const result = Array.prototype.unshift.call(arrayLike, "first");
console.log(result, arrayLike.length, arrayLike[0], 1 in arrayLike, arrayLike[2]);

Ergebnis

4 lint,build,test,deploy
3 true false true a b
3 3 first false second

Quellen