Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri