CKTIS / JavaScript
Array.prototype.toSpliced: geänderte Kopie ohne Mutation
toSpliced gibt nach Entfernen und Einfügen gewählter Positionen ein neues Array zurück und lässt den Empfänger unverändert.
Version: ECMAScript 2023; example target: Node.js 24.22.2
Syntax
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) ist die kopierende Entsprechung zu splice(): Es erstellt ein neues gewöhnliches Array, überspringt einen Bereich, fügt items ein und lässt array unverändert. Ein negatives start zählt vom Ende; eine Position hinter der Länge bedeutet das Ende. Bei vorhandenem start entfernt ein fehlendes skipCount den Rest, ausdrücklich undefined bedeutet null, andere Werte werden auf den verfügbaren Bereich begrenzt.
Das Ergebnis ist die vollständige geänderte Kopie, nicht ein Array entfernter Elemente. Es ist flach, immer dicht und beachtet Symbol.species nicht: Lücken werden zu eigenen Eigenschaften mit undefined. Ohne Argumente entsteht eine dichte Kopie.
Die in ECMAScript 2023 standardisierte Methode ist für array-ähnliche Werte generisch. Ein Empfänger null oder undefined löst TypeError aus; eine übergroße berechnete Länge ergibt TypeError oder RangeError, Fehler aus Konvertierung, Gettern und Proxy-Traps werden weitergegeben.
Beispiele
const source = ["build", "test", "deploy"];
const changed = source.toSpliced(1, 1, "lint", "test");
console.log(changed.join(","));
console.log(source.join(","));
console.log(source.toSpliced(-1).join(","));
console.log(source.toSpliced(1, undefined, "docs").join(","));
const dense = [1, , 3].toSpliced(1, 0, 2);
console.log(dense.length, 0 in dense, 1 in dense, 2 in dense, 3 in dense);
console.log(dense[0], dense[1], String(dense[2]), dense[3]);Ergebnis
build,lint,test,deploy build,test,deploy build,test build,docs,test,deploy 4 true true true true 1 2 undefined 3