Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Array.prototype.splice: odstranění, nahrazení a vložení

splice změní pole na zvolené pozici, posune jeho konec a vrátí nové pole odstraněných prvků.

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

Syntaxe

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

array.splice(start, deleteCount?, ...items) změní array na místě a vrátí nové pole odstraněných prvků. start se převede na celé číslo: záporná hodnota počítá od konce a pozice za délkou znamená konec. Je-li zadán start, ale deleteCount vynechán, odstraní se celý zbytek; výslovné undefined znamená nulu. Jiné hodnoty se omezí mezi nulu a počet zbývajících prvků. items se vloží před posunutý konec.

Délka výsledku odpovídá počtu odstraněných pozic a příslušné díry zůstanou dírami. Příjemce může narůst, zkrátit se nebo délku zachovat; splice() bez argumentů nic neodstraní. U podtříd Array tvorba výsledku respektuje Symbol.species.

Metoda je obecná pro měnitelné array-like objekty: čte length, kopíruje nebo maže indexované vlastnosti a zapisuje novou délku. Může vyvolat TypeError, pokud jsou zápis, mazání či length zakázány nebo by nová délka přesáhla 2^53 - 1; chyby převodu, přístupových metod, proxy trapů a species konstruktoru se šíří.

Pří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ýsledek

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

Zdroje