CKTIS / JavaScript
Array.prototype.toSpliced: promijenjena kopija bez mutacije
toSpliced vraća novo polje nakon uklanjanja i umetanja odabranih mjesta, bez mijenjanja primatelja.
Verzija: ECMAScript 2023; example target: Node.js 24.22.2
Sintaksa
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) kopirajuća je inačica splice(): stvara novi obični Array, preskače odabrani raspon, umeće items i ostavlja array nepromijenjenim. Negativan start broji od kraja; položaj iza duljine znači kraj. Uz zadani start, izostavljeni skipCount uklanja rep, izričito undefined znači nulu, a druge vrijednosti ograničavaju se na raspoloživi raspon.
Rezultat je cijela promijenjena kopija, ne polje uklonjenih elemenata. Plitka je, uvijek gusta i zanemaruje Symbol.species: rupe postaju vlastita svojstva s vrijednošću undefined. Bez argumenata nastaje gusta kopija.
Metoda iz ECMAScript 2023 generička je za array-like vrijednosti. Primatelj null ili undefined baca TypeError; prevelika izračunata duljina daje TypeError ili RangeError, a pogreške pretvorbe, gettera i proxy zamki šire se.
Primjeri
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]);Rezultat
build,lint,test,deploy build,test,deploy build,test build,docs,test,deploy 4 true true true true 1 2 undefined 3