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

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

Viri