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