WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Array.prototype.splice: Entfernen, Ersetzen und Einfügen

splice verändert ein Array an einer gewählten Stelle, verschiebt seinen Rest und gibt entfernte Elemente als neues Array zurück.

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

Syntax

array.splice(start, deleteCount?, ...items)

array.splice(start, deleteCount?, ...items) ändert array an Ort und Stelle und liefert ein neues Array der entfernten Elemente. start wird ganzzahlig umgewandelt: Ein negativer Wert zählt vom Ende, eine Position hinter der Länge bezeichnet das Ende. Ist start angegeben und deleteCount weggelassen, wird der ganze Rest entfernt; ausdrücklich übergebenes undefined bedeutet null. Andere Werte werden zwischen null und der verbleibenden Elementzahl begrenzt. items werden vor dem verschobenen Rest eingefügt.

Die Ergebnislänge entspricht der Zahl entfernter Positionen; zugehörige Lücken bleiben Lücken. Der Empfänger kann wachsen, schrumpfen oder gleich lang bleiben; splice() ohne Argumente entfernt nichts. Bei Array-Unterklassen berücksichtigt die Ergebniserzeugung Symbol.species.

Die Methode ist für veränderbare array-ähnliche Objekte generisch: Sie liest length, kopiert oder löscht indizierte Eigenschaften und schreibt die neue Länge. TypeError ist möglich, wenn Schreiben, Löschen oder length nicht erlaubt sind oder die neue Länge 2^53 - 1 überschritte; Fehler aus Konvertierung, Zugriffsmethoden, Proxy-Traps und Species-Konstruktor werden weitergegeben.

Beispiele

const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));

const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));

const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));

const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));

Ergebnis

test
build,lint,test,deploy
test,deploy
build,lint
0 build,docs,lint
2 false true b c

Quellen