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

CKTIS / JavaScript

Array.prototype.copyWithin: kopie rozsahu v témže poli

copyWithin kopíruje prvky uvnitř stejného příjemce, zachová délku a bezpečně řeší překrývající se rozsahy.

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

Syntaxe

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

array.copyWithin(target, start[, end]) mění příjemce a vrací přesně tento objekt. Kopíruje [start, end) na target; záporné indexy počítají od konce a zlomky se oříznou. Délka se nemění.

Podobně jako memmove volí směr, aby překryv nezničil dosud potřebné hodnoty. Díra ve zdroji odstraní cílovou vlastnost. Metoda je obecná pro zapisovatelné array-like objekty; vlastnost jen pro čtení nebo chyba proxy může vyvolat TypeError. Příklad kopíruje konec doprostřed.

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

1,4,5,4,5
true 5

Zdroje