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

CKTIS / JavaScript

Array.prototype.copyWithin: kopírovanie rozsahu v tom istom poli

copyWithin kopíruje prvky v rovnakom prijímateľovi, zachová dĺžku a bezpečne rieši prekrývajúce sa rozsahy.

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

Syntax

array.copyWithin(target, start[, end])

array.copyWithin(target, start[, end]) mení prijímateľa a vracia presne tento objekt. Kopíruje [start, end) na target; záporné indexy počítajú od konca a zlomky sa orežú. Dĺžka sa nemení.

Podobne ako memmove volí smer, aby prekryv nezničil ešte potrebné hodnoty. Diera v zdroji odstráni cieľovú vlastnosť. Metóda je všeobecná pre zapisovateľné array-like objekty; vlastnosť iba na čítanie alebo chyba proxy môže vyvolať TypeError. Príklad kopíruje koniec doprostred.

Príklady

const values = [1, 2, 3, 4, 5];
const returned = values.copyWithin(1, 3);
console.log(values.join(","));
console.log(returned === values, values.length);

Výsledok

1,4,5,4,5
true 5

Zdroje