База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Array.prototype.copyWithin: копиране на диапазон в същия масив

copyWithin копира елементи в същия получател, запазва дължината и безопасно обработва припокриващи се диапазони.

Версия: ECMAScript 2026 draft; example target: Node.js 24.22.2

Синтаксис

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

array.copyWithin(target, start[, end]) променя получателя и връща точно същия обект. Копира [start, end) към target; отрицателните индекси броят от края, дробите се отрязват. Дължината не се променя.

Подобно на memmove, алгоритъмът избира посока, за да не унищожи нужни стойности при припокриване. Празно място в източника изтрива целевото свойство. Методът е общ за записваеми array-like обекти; read-only свойство или грешка от proxy може да хвърли TypeError. Примерът копира края в средата.

Примери

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

Резултат

1,4,5,4,5
true 5

Източници