CKTIS / JavaScript
Array.prototype.toSpliced: spremenjena kopija brez mutacije
toSpliced vrne novo tabelo po odstranitvi in vstavitvi izbranih mest, ne da bi spremenil prejemnika.
Različica: ECMAScript 2023; example target: Node.js 24.22.2
Sintaksa
array.toSpliced(start, skipCount?, ...items)array.toSpliced(start, skipCount?, ...items) je kopirna različica splice(): ustvari nov navaden Array, izpusti izbrani odsek, vstavi items in pusti array nespremenjen. Negativen start šteje od konca; položaj čez dolžino pomeni konec. Ob podanem start manjkajoči skipCount odstrani rep, izrecni undefined pomeni nič, druge vrednosti pa se omejijo na razpoložljivi obseg.
Rezultat je celotna spremenjena kopija, ne tabela odstranjenih elementov. Je plitva, vedno gosta in ne upošteva Symbol.species: luknje postanejo lastne lastnosti z vrednostjo undefined. Brez argumentov nastane gosta kopija.
Metoda iz ECMAScript 2023 je splošna za array-like vrednosti. Prejemnik null ali undefined sproži TypeError; prevelika izračunana dolžina povzroči TypeError ali RangeError, napake pretvorbe, getterjev in proxy pasti pa se širijo.
Primeri
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