CKTIS / JavaScript
Array.prototype.splice: odstranjevanje, zamenjava in vstavljanje
splice spremeni tabelo na izbranem mestu, premakne njen rep in vrne novo tabelo odstranjenih elementov.
Različica: ECMAScript 2026 draft; example target: Node.js 24.22.2
Sintaksa
array.splice(start, deleteCount?, ...items)array.splice(start, deleteCount?, ...items) spremeni array na mestu in vrne novo tabelo odstranjenih elementov. start se pretvori v celo število: negativna vrednost šteje od konca, položaj čez dolžino pa pomeni konec. Če je start podan, deleteCount pa izpuščen, odstrani ves rep; izrecni undefined pomeni nič. Druge vrednosti so omejene med nič in številom preostalih elementov. items se vstavijo pred premaknjeni rep.
Dolžina rezultata je enaka številu odstranjenih mest, pripadajoče luknje pa ostanejo luknje. Prejemnik se lahko podaljša, skrajša ali ohrani dolžino; splice() brez argumentov ne odstrani ničesar. Pri podrazredih Array ustvarjanje rezultata upošteva Symbol.species.
Metoda je splošna za spremenljive array-like objekte: prebere length, kopira ali izbriše indeksirane lastnosti in zapiše novo dolžino. Lahko sproži TypeError, če so pisanje, brisanje ali length prepovedani ali bi nova dolžina presegla 2^53 - 1; napake pretvorbe, dostopnikov, proxy pasti in konstruktorja species se širijo.
Primeri
const queue = ["build", "test", "deploy"];
const removed = queue.splice(1, 1, "lint", "test");
console.log(removed.join(","));
console.log(queue.join(","));
const tail = queue.splice(-2);
console.log(tail.join(","));
console.log(queue.join(","));
const none = queue.splice(1, undefined, "docs");
console.log(none.length, queue.join(","));
const sparse = [, "b", "c"];
const cut = sparse.splice(0, 2);
console.log(cut.length, 0 in cut, 1 in cut, cut[1], sparse.join(","));Rezultat
test build,lint,test,deploy test,deploy build,lint 0 build,docs,lint 2 false true b c