Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Array.prototype.splice: odstránenie, nahradenie a vloženie

splice zmení pole na zvolenej pozícii, posunie jeho koniec a vráti nové pole odstránených prvkov.

Verzia: ECMAScript 2026 draft; example target: Node.js 24.22.2

Syntax

array.splice(start, deleteCount?, ...items)

array.splice(start, deleteCount?, ...items) zmení array na mieste a vráti nové pole odstránených prvkov. start sa prevedie na celé číslo: záporná hodnota počíta od konca a pozícia za dĺžkou znamená koniec. Ak je zadaný start, ale deleteCount vynechaný, odstráni sa celý zvyšok; výslovné undefined znamená nulu. Iné hodnoty sa obmedzia medzi nulu a počet zostávajúcich prvkov. items sa vložia pred posunutý koniec.

Dĺžka výsledku zodpovedá počtu odstránených pozícií a príslušné diery zostanú dierami. Prijímateľ môže narásť, skrátiť sa alebo dĺžku zachovať; splice() bez argumentov nič neodstráni. Pri podtriedach Array tvorba výsledku rešpektuje Symbol.species.

Metóda je všeobecná pre meniteľné array-like objekty: číta length, kopíruje alebo maže indexované vlastnosti a zapisuje novú dĺžku. Môže vyvolať TypeError, ak sú zápis, mazanie či length zakázané alebo by nová dĺžka presiahla 2^53 - 1; chyby prevodu, prístupových metód, proxy trapov a species konštruktora sa šíria.

Príklady

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(","));

Výsledok

test
build,lint,test,deploy
test,deploy
build,lint
0 build,docs,lint
2 false true b c

Zdroje