WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.push: am Ende anhängen

push hängt beliebig viele Werte ab der aktuellen Länge an und liefert die neue Länge des Empfängers.

Version: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.push(...items)

array.push(...items) liest length, schreibt die Elemente nacheinander ab diesem Index, setzt die neue length und liefert sie als Zahl. Argumente werden ohne Abflachung gespeichert; ein Aufruf ohne Argumente liefert weiterhin die aktuelle Länge. Die Methode mutiert den Empfänger und ist für veränderliche array-ähnliche Objekte generisch.

null oder undefined als Empfänger löst TypeError aus. Würden Länge und Argumentanzahl die maximale sichere Länge 2^53 - 1 überschreiten, löst der Algorithmus TypeError aus. Für ein echtes Array gilt zusätzlich das Längenlimit 2^32 - 1. Ein nicht schreibbarer Index, eine schreibgeschützte length oder ein Proxy-Trap kann einen Fehler auslösen; frühere Schreibvorgänge müssen nicht zurückgerollt werden. Das Beispiel zeigt ein Array, ein array-ähnliches Objekt und einen nicht erweiterbaren Empfänger.

Beispiele

const values = ["a"];
console.log(values.push("b", "c"), values.join(","));
const record = { 0: "x", length: 1 };
console.log(Array.prototype.push.call(record, "y", "z"), record.length, record[1] + record[2]);
const fixed = Object.preventExtensions(["x"]);
try { fixed.push("y"); } catch (error) {
  console.log(error.name, fixed.length);
}

Ergebnis

3 a,b,c
3 3 yz
TypeError 1

Quellen