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

CKTIS / JavaScript

Array.prototype.toSpliced: zmenená kópia bez mutácie

toSpliced vráti nové pole po odstránení a vložení vybraných pozícií bez zmeny prijímateľa.

Verzia: ECMAScript 2023; example target: Node.js 24.22.2

Syntax

array.toSpliced(start, skipCount?, ...items)

array.toSpliced(start, skipCount?, ...items) je kopírujúca obdoba splice(): vytvorí nové bežné Array, vynechá zvolený úsek, vloží items a ponechá array bez zmeny. Záporný start počíta od konca; pozícia za dĺžkou znamená koniec. Pri zadanom start odstráni chýbajúci skipCount zvyšok, výslovné undefined znamená nulu a iné hodnoty sa obmedzia na dostupný rozsah.

Výsledkom je celá zmenená kópia, nie pole odstránených prvkov. Je plytká, vždy hustá a nepoužíva Symbol.species: diery prijímateľa sa stanú vlastnými vlastnosťami s hodnotou undefined. Bez argumentov vznikne hustá kópia.

Metóda z ECMAScript 2023 je všeobecná pre array-like hodnoty. Prijímateľ null alebo undefined vyvolá TypeError; príliš veľká vypočítaná dĺžka spôsobí TypeError či RangeError a chyby prevodu, getterov a proxy trapov sa šíria.

Príklady

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]);

Výsledok

build,lint,test,deploy
build,test,deploy
build,test
build,docs,test,deploy
4 true true true true
1 2 undefined 3

Zdroje