CKTIS / JavaScript
Array.prototype.toSpliced: změněná kopie bez mutace
toSpliced vrátí nové pole po odstranění a vložení vybraných pozic, aniž změní příjemce.
Verze: ECMAScript 2023; example target: Node.js 24.22.2
Syntaxe
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) je kopírující obdoba splice(): vytvoří nové běžné Array, vynechá zvolený úsek, vloží items a ponechá array beze změny. Záporný start počítá od konce; pozice za délkou znamená konec. Při zadaném start odstraní chybějící skipCount zbytek, výslovné undefined znamená nulu a jiné hodnoty se omezí na dostupný rozsah.
Výsledkem je celá změněná kopie, nikoli pole odstraněných prvků. Je mělká, vždy hustá a nepoužívá Symbol.species: díry příjemce se stanou vlastními vlastnostmi s hodnotou undefined. Bez argumentů vznikne hustá kopie.
Metoda z ECMAScript 2023 je obecná pro array-like hodnoty. Příjemce null nebo undefined vyvolá TypeError; příliš velká vypočtená délka způsobí TypeError či RangeError a chyby převodu, getterů a proxy trapů se šíří.
Příklady
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]);Výsledek
build,lint,test,deploy build,test,deploy build,test build,docs,test,deploy 4 true true true true 1 2 undefined 3